MCP-YNU - FastMCP 服务器

一个动态的 MCP 服务器实现，使用 FastMCP，可以自动从相应的目录加载工具、资源和提示。

特性

• 从 tools/、resources/ 和 prompts/ 目录动态加载模块
• 自动发现和注册模块
• 简单的配置和可扩展性
• 类型提示，以提高代码清晰度和静态分析能力
• 全面的日志记录，用于监控服务器活动

最近更新

• 在整个代码库中添加了类型提示
• 改进了 MCP 实例处理
• 添加了日志记录功能
• 添加了 MIT 许可证
• 使用参考链接更新了文档

目录结构

mcp-ynu/
├── tools/          # 工具模块目录
│   ├── __init__.py
│   ├── example.py
├── resources/      # 资源模块目录
│   ├── __init__.py
│   ├── example.py
├── prompts/        # 提示模块目录
│   ├── __init__.py
│   ├── example.py
├── logger.py       # 日志记录器实现
├── main.py         # 主要实现
├── mcp_server.py   # MCP 服务器实现
├── README.md       # 项目文档
├── LICENSE         # MIT 许可证
└── pyproject.toml  # 项目配置

用法

1. 在相应的目录中创建模块
2. 通过 from mcp_server import mcp 导入 mcp
3. 运行服务器：

python main.py

示例模块

工具模块示例 (tools/example.py)

from mcp_server import mcp
import httpx

@mcp.tool()
def calculate_bmi(weight_kg: float, height_m: float) -> float:
    """计算给定公斤体重和米身高的 BMI"""
    return weight_kg / (height_m**2)


@mcp.tool()
async def fetch_weather(city: str) -> str:
    """获取城市当前天气"""
    async with httpx.AsyncClient() as client:
        response = await client.get(f"https://api.weather.com/{city}")
        return response.text

资源模块示例 (resources/example.py)

from mcp_server import mcp

@mcp.resource("config://app")
def get_config() -> str:
    """静态配置数据"""
    return "App configuration here"


@mcp.resource("users://{user_id}/profile")
def get_user_profile(user_id: str) -> str:
    """动态用户数据"""
    return f"Profile data for user {user_id}"

提示模块示例 (prompts/example.py)

from mcp_server import mcp
from mcp.server.fastmcp.prompts import base

@mcp.prompt()
def review_code(code: str) -> str:
    return f"Please review this code:\n\n{code}"


@mcp.prompt()
def debug_error(error: str) -> list[base.Message]:
    return [
        base.UserMessage("I'm seeing this error:"),
        base.UserMessage(error),
        base.AssistantMessage("I'll help debug that. What have you tried so far?"),
    ]

调试

1. 更新 .env 中的 MCP_TRANSPORT_TYPE，执行 python main.py 启动 mcp 服务器
2. 执行 npx @modelcontextprotocol/inspector 打开 inspect。
3. 选择 SSE 传输类型，URL 为 http://localhost:<mcp_server_port>/sse，或者选择 STDIO 传输类型，命令为 python，参数为 /path/to/main.py

要求

• Python >= 3.10
• FastMCP

参考链接

• MCP Python SDK 文档
• MCP 核心概念
• FastMCP 实现

许可证

该项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。