🚀 MCP-YNU - FastMCP 服务器

MCP-YNU - FastMCP 服务器是一个借助 FastMCP 实现的动态 MCP 服务器，它能够自动从对应目录加载工具、资源和提示，为用户提供便捷高效的服务。

🚀 快速开始

环境要求

• 需要 Python 3.8 或更高版本
• 需要安装 FastMCP 和相关依赖项

操作步骤

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

python main.py

✨ 主要特性

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

📦 安装指南

本项目需要 Python 3.8 或更高版本，同时需要安装 FastMCP 和相关依赖项。

💻 使用示例

基础用法

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

from mcp_server import mcp
import httpx

@mcp工具()
def calculate_bmi(weight_kg: float, height_m: float) -> float:
    """根据体重（公斤）和身高（米）计算 BMI"""
    return weight_kg / (height_m**2)


@mcp工具()
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资源("config://app")
def get_config() -> str:
    """静态配置数据"""
    return "应用程序配置信息"


@mcp资源("users://{user_id}/profile")
def get_user_profile(user_id: str) -> str:
    """动态用户数据"""
    return f"用户 {user_id} 的个人资料信息"

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

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

@mcp提示()
def review_code(code: str) -> str:
    return f"请审核以下代码:\n\n{code}"


@mcp提示()
def debug_error(error: str) -> list[base.Message]:
    return [
        base.UserMessage("我看到这个错误："),
        base.UserMessage(error),
        base.AssistantMessage("我会帮助你调试。"),
    ]

📚 详细文档

最近更新

• 在整个代码库中添加了类型的提示
• 改进了 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. 设置环境变量 MCP_DEBUG=1 启用调试模式
2. 在终端中运行服务器命令：

python main.py --debug

3. 查看控制台输出以获取调试信息

参考链接

• FastMCP 官方文档
• Python 官方文档

📄 许可证

本项目受 MIT 许可证保护。查看 LICENSE 了解详细信息。