使用说明

项目简介

本仓库 'mcp-servers' 提供了一组简单的MCP服务器示例，演示了如何使用 Python 和 'fastmcp' 库构建 MCP 服务器，对外提供工具和Prompt能力。目前包含了天气查询工具（'weather.py'）和BMI计算工具（'bmi_calculator.py'）两个示例。您可以参考这些示例，了解 MCP 服务器的基本结构和开发流程，并根据自身需求扩展或定制功能。

主要功能点

工具 (Tools)：
- 'weather.py' 提供了 'get_alerts' (获取美国州的天气警报) 和 'get_forecast' (获取经纬度位置的天气预报) 两个工具。
- 'bmi_calculator.py' 提供了 'calculate_bmi' (计算BMI) 工具。
Prompt 模板 (Prompts)：
- 'weather.py' 提供了 'prompt_get_alerts' Prompt 模板，用于引导 LLM 调用 'get_alerts' 工具并以中文回复。

安装步骤

克隆仓库

git clone https://github.com/goofansu/mcp-servers
cd mcp-servers

创建虚拟环境并安装依赖

推荐使用 'uv' 进行环境管理，如果未安装请先安装 'uv' (安装指南)。

uv venv
uv sync
source .venv/bin/activate  # 或根据你的shell环境选择激活命令，例如 source .venv/bin/activate.fish

安装 MCP 服务器

使用 'mcp install' 命令安装你需要的 MCP 服务器示例。例如，安装 'weather.py'：

mcp install weather.py

或者同时安装多个：

mcp install weather.py bmi_calculator.py

服务器配置

要让 MCP 客户端（例如 Claude Desktop）连接到这些 MCP 服务器，您需要配置客户端的 MCP 服务器设置。以 Claude Desktop 为例，您需要在其配置文件中添加或修改 'mcpServers' 部分。

以下是 'weather.py' 服务器的配置示例，您需要根据实际情况调整 'command' 和 'args' 中的路径：

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "/path/to/mcp-servers/weather.py"  // 将 "/path/to/mcp-servers/weather.py" 替换为 weather.py 文件的实际路径
      ]
    },
    "bmi_calculator": {  // BMI 计算器服务器配置示例
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "/path/to/mcp-servers/bmi_calculator.py"  // 将 "/path/to/mcp-servers/bmi_calculator.py" 替换为 bmi_calculator.py 文件的实际路径
      ]
    }
    // ... 其他 MCP 服务器配置
  }
}

配置说明：

'"weather"' 和 '"bmi_calculator"': 服务器名称，在 MCP 客户端中用于标识不同的服务器。您可以自定义名称。
'"command": "uv"': 启动服务器的命令。这里使用 'uv run' 来运行 Python 脚本。如果您的环境中 Python 可直接执行，也可以将 'command' 设置为 'python'，并相应调整 'args'。
'"args"': 传递给 'command' 的参数列表。
- '"run"', '"--with"', '"mcp"', '"mcp"': 'mcp install' 脚本已经配置好，通常无需修改。
- '"run"': 'uv run' 的子命令，用于运行 Python 脚本。
- '"/path/to/mcp-servers/weather.py"' 或 '"/path/to/mcp-servers/bmi_calculator.py"': 这是最重要的参数，请务必替换为 'weather.py' 或 'bmi_calculator.py' 文件在您本地文件系统中的绝对路径。 您需要根据您克隆仓库的路径进行修改。

如何找到 Claude Desktop 配置文件：

不同操作系统，Claude Desktop 配置文件位置可能不同，通常在用户配置目录下，例如：

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'
Linux: '~/.config/Claude/claude_desktop_config.json' 或 '~/.var/app/ai.claude.Claude/config/Claude/claude_desktop_config.json' (Flatpak)

请根据您的操作系统和 Claude Desktop 安装方式查找配置文件，并编辑 'mcpServers' 部分。

基本使用方法

启动 Claude Desktop 或其他 MCP 客户端。
在客户端的设置或工具栏中，找到 "MCP Tools" 或 "Available MCP Tools" 选项。 您应该能看到已配置的 MCP 服务器提供的工具，例如 "get_alerts", "get_forecast", "calculate_bmi" 等。
选择您需要的工具，并根据工具的参数提示，在聊天对话框中输入相应的参数。 例如，要使用 'get_alerts' 工具查询加州的天气警报，您可以输入类似 'get_alerts state=CA' 的指令。
对于 Prompt 模板，您可以在客户端的 Prompt 选择菜单中找到 "Attach from MCP" 选项。 选择相应的 Prompt 模板，例如 "prompt_get_alerts"，然后按照提示操作。

Inspect MCP servers

如果 Claude Desktop 报告 MCP 服务器错误，您可以使用 'mcp dev' 命令调试：

mcp dev weather.py

这将启动一个开发服务器，并输出详细日志，帮助您诊断问题。

关键词