MCP Ynu

🚀 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 瞭解詳細信息。