AI导哈

MCP服务器模板

提供本地开发的模型上下文协议（MCP）服务器模板，包括天气API、计算器和笔记功能。

  • by gupta-ujjwal
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 gupta-ujjwal/mcp-server-templates

使用说明

MCP服务器模板

此存储库提供了一个模板，用于为本地开发设置模型上下文协议（MCP）服务器。它包括不同MCP服务器实现的示例：

  1. 天气API -提供天气警报和预报
  2. 计算器 -基础和高级数学运算
  3. 备注 -具有本地文件存储的简单笔记功能

备注：此项目需要Python 3.10或更高版本。有关使用正确Python版本的说明，请参阅脚注。

项目结构

├── servers/          # MCP server implementations
│   ├── calculator.py # Calculator server implementation
│   ├── notes.py      # Notes server implementation
│   └── weather.py    # Weather API server implementation
├── docs/             # Documentation for the servers
├── requirements.txt  # Python dependencies
└── README.md         # This file

需求

  • 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  # On Windows: venv\Scripts\activate

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

    pip install uv

  4. 使用UV安装依赖项：

    uv pip install -r requirements.txt

用法

运行MCP服务器

每个MCP服务器都可以使用MCP dev-server命令运行：

Weather API服务器

mcp dev servers/weather.py

Weather API提供了以下工具：

  • get_alerts：获取美国某州的天气警报
  • get_forecast：根据纬度和经度获取某个位置的天气预报

计算器服务器

mcp dev servers/calculator.py

计算器提供数学运算，包括：

  • 基本操作：加、减、乘、除
  • 高级操作：power、sqrt、cbrt、factorial、log等。
  • 三角函数：sin、cos、tan

Notes服务器

mcp dev servers/notes.py

Notes服务器提供笔记管理功能，包括：

  • add_note：创建一个带有标题和内容的新笔记
  • list_notes：获取所有已保存的笔记
  • get_note：按ID检索特定笔记
  • delete_note：按ID删除注释
  • search_notes：查找包含特定关键字的笔记
  • update_note：修改现有注释的标题或内容

VS代码集成

这些MCP服务器可以与Visual Studio Code集成，以便与AI助手一起使用。配置您的 settings.json 包括：

{
  "mcp": {
    "servers": {
      "weather": {
        "command": "bash",
        "args": [
          "-c",
          "source {AbsolutePathToTheFolder}/venv/bin/activate && uv --directory {AbsolutePathToTheFolder} run servers/weather.py"
        ]
      },
      "calculator": {
        "command": "bash",
        "args": [
          "-c",
          "source {AbsolutePathToTheFolder}/venv/bin/activate && uv --directory {AbsolutePathToTheFolder} run servers/calculator.py"
        ]
      },
      "notes": {
        "command": "bash",
        "args": [
          "-c",
          "source {AbsolutePathToTheFolder}/venv/bin/activate && uv --directory {AbsolutePathToTheFolder} run servers/notes.py"
        ]
      }
    }
  }
}

许可证

此项目根据Apache许可证2.0获得许可。请参阅 许可证 文件以获取详细信息。

脚注

使用Python 3.10+

  1. 检查你的Python版本:

    python --version

  2. 如果需要，安装Python 3.10或更高版本:

    • macOS （使用Homebrew）：
      brew install python@3.10
    • Linux:
      sudo apt-get update
sudo apt-get install python3.10
    • 视窗：从下载安装程序 python.org

  3. 使用pyenv管理多个Python版本 （推荐）：

    # Install pyenv
brew install pyenv  # macOS

# Install Python version
pyenv install 3.10.0

# Set local Python version
pyenv local 3.10.0

  4. 在pyenv中使用UV:

    # After setting up pyenv and activating your environment
pip install uv
uv pip install -r requirements.txt

参考文献和进一步阅读

相关 MCP