MCP Server Templates

🚀 MCP 服務器模板

本倉庫提供了一個用於本地開發的 MCP（模型上下文協議）服務器設置模板。它包含了不同 MCP 服務器實現的示例，具體如下：

• 天氣 API：可提供天氣警報和預報服務。
• 計算器：支持基本和高級數學運算。
• Notes：具備簡單的筆記功能，支持本地文件存儲。

⚠️ 重要提示

該項目要求 Python 3.10 或更高版本。有關使用正確 Python 版本的說明，請參見腳註。

🚀 快速開始

項目結構

├── servers/          # MCP 服務器實現
│   ├── calculator.py # 計算器服務器實現
│   ├── notes.py      # Notes 服務器實現
│   └── weather.py    # 天氣 API 服務器實現
├── docs/             # 文檔
├── requirements.txt  # Python 依賴項
└── README.md         # 此文件

需求

• Python 3.10+
• FastMCP 庫
• requirements.txt 中列出的其他依賴項
• UV 包管理器（推薦用於更快安裝）

設置

1. 克隆倉庫：

   git clone <repository-url>
   cd mcp-server-templates
   

2. 創建虛擬環境（推薦）：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
   

3. 安裝 UV 包管理器（如果尚未安裝）：

   pip install uv
   

4. 使用 UV 安裝依賴項：

   uv pip install -r requirements.txt
   

✨ 主要特性

天氣 API 服務器

• 提供 get_alerts 工具，可獲取美國州的天氣警報。
• 提供 get_forecast 工具，能根據緯度和經度獲取位置的天氣預報。

計算器服務器

• 支持基本運算，如加、減、乘、除。
• 支持高級運算，如平方根、指數等。
• 支持括號和連續運算。

Notes 服務器

• create_note：創建新筆記。
• retrieve_note：通過 ID 檢索筆記。
• update_note：更新現有筆記。
• delete_note：刪除筆記。
• list_notes：列出所有筆記。

💻 使用示例

運行 MCP 服務器

每個 MCP 服務器都可以使用 MCP 開發服務器命令運行。

天氣 API 服務器

mcp dev servers/weather.py

計算器服務器

mcp dev servers/calculator.py

Notes 服務器

mcp dev servers/notes.py

VS Code 集成

在 VS Code 中使用時，可以將服務器作為語言服務器安裝，並提供以下配置：

{
    "mcp.servers": {
        "calculator": {
            "path": "servers/calculator.py",
            "args": []
        },
        "notes": {
            "path": "servers/notes.py",
            "args": []
        },
        "weather": {
            "path": "servers/weather.py",
            "args": []
        }
    }
}

📄 許可證

• MCP 介紹及官方文檔
• MCP Python 包在 PyPI 上

腳註：

1. Python 版本要求：

   • 建議使用 Python 3.8 或更高版本。
   • 安裝指定 Python 版本的方法包括使用 pyenv、virtualenv 或 Anaconda。

2. 使用 Pyenv 的示例：

   # 安裝 pyenv 並設置 Python 版本
   brew install pyenv
   pyenv install 3.10
   pyenv global 3.10
   
   # 激活虛擬環境（可選）
   python -m venv mcp_env
   source mcp_env/bin/activate
   

3. 在 Anaconda 中使用示例：

   conda create -n mcp python=3.10
   conda activate mcp
   pip install uv
   uv pip install -r requirements.txt
   

4. 依賴管理提示：

   • 使用 uv 可以並行安裝依賴，加速安裝過程。
   • 對於特定 Python 版本的依賴，請參閱 requirements.txt。

5. 運行時注意事項：

   • 確保所有依賴項已正確安裝。
   • 在生產環境中使用前，請進行充分測試和優化。