使用说明

项目简介

本项目是一个MCP服务器的开发指南，并提供了一个基础的Python实现示例。它旨在帮助开发者理解如何构建MCP服务器，以便将外部数据源和工具集成到Anthropic的Claude等大型语言模型中。通过遵循本指南，开发者可以快速搭建一个能够扩展Claude功能的MCP服务器。

主要功能点

工具注册与调用: 允许开发者注册自定义工具（例如，访问外部API、数据库查询等），并使Claude能够通过MCP协议调用这些工具，扩展Claude的功能。示例代码中展示了如何定义和注册一个简单的工具。
基础服务器框架: 提供了一个基于Python和 'mcp' 库构建MCP服务器的基本框架，包括服务器初始化、工具注册和运行等核心步骤。
与Claude Desktop集成: 提供了详细的配置步骤，指导用户如何将开发的MCP服务器与Claude Desktop客户端连接，实现工具的调用。
开发指南: 通过清晰的步骤和代码示例，引导开发者完成MCP服务器的搭建过程，包括环境配置、代码实现、客户端配置和测试。

安装步骤

创建项目目录: 在本地创建一个新的文件夹作为项目目录，例如 'my_mcp_server'。

mkdir my_mcp_server
cd my_mcp_server

创建并激活虚拟环境 (推荐): 为了隔离项目依赖，建议创建并激活一个Python虚拟环境。

python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate  # Windows

安装依赖: 创建 'requirements.txt' 文件，并添加以下内容：

mcp
httpx

然后安装依赖：

pip install -r requirements.txt

创建 'server.py' 文件: 复制仓库提供的 'server.py' 文件内容到项目目录中。此文件包含了MCP服务器的Python代码。
创建 'claude_desktop_config.json' 文件: 复制仓库提供的 'claude_desktop_config.json' 文件内容到项目目录中。此文件用于配置Claude Desktop客户端连接到你的MCP服务器。

服务器配置

要使Claude Desktop客户端连接到你本地运行的MCP服务器，需要修改Claude Desktop的配置文件。你需要将以下JSON配置添加到Claude Desktop的配置文件 ('claude_desktop_config.json') 中。请注意，以下配置信息为JSON格式，不需要代码块标识。

{
  "mcpServers": {
    "my_server": {  // 服务器名称，可以自定义，在Claude客户端中用于识别
      "command": "python",  // 启动服务器的命令，这里使用python解释器
      "args": [
        "/ABSOLUTE/PATH/TO/my_mcp_server/server.py"  // 服务器脚本的绝对路径，**请务必替换为你的实际路径**
      ]
    }
  }
}

配置说明:

'"mcpServers"': Claude Desktop客户端配置MCP服务器的根节点。
'"my_server"': 你自定义的服务器名称，用于在Claude客户端中识别和管理不同的MCP服务器。
'"command"': 启动MCP服务器进程的命令。通常是Python解释器的路径 ('python' 或 'python3')，前提是你的Python环境已正确配置到系统路径。
'"args"': 一个字符串数组，包含传递给 'command' 的参数。
- '" /ABSOLUTE/PATH/TO/my_mcp_server/server.py"': 这是最重要的参数，需要替换为 'server.py' 文件在你电脑上的绝对路径。 例如，如果你的项目放在 'C:\projects\my_mcp_server'，则应替换为 '"C:\projects\my_mcp_server\server.py"' (注意Windows路径中的反斜杠需要转义)。

查找 Claude Desktop 配置文件路径:

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

将上述JSON配置合并到 Claude Desktop 的 'claude_desktop_config.json' 文件中（如果文件已存在，注意不要覆盖原有内容，而是将 '"mcpServers"' 部分添加到已有的JSON结构中）。

基本使用方法

启动 MCP 服务器: 在项目目录中，运行以下命令启动 MCP 服务器：
```
python server.py
```
服务器将在后台运行，并通过标准输入/输出与客户端通信。
启动 Claude Desktop 客户端: 启动或重启 Claude Desktop 应用程序。
连接状态确认: 如果配置正确，在 Claude Desktop 的输入框右下角应该会出现一个锤子图标，表示MCP服务器已成功连接。
测试工具: 点击锤子图标，可以查看已注册的工具列表。在对话中，你可以指示 Claude 使用这些工具，例如，你可以对Claude说 "请使用 my_tool 工具"。服务器端的 'my_tool' 函数将被调用，并将结果返回给 Claude。

注意: 示例代码中的 'my_tool' 只是一个简单的占位符，你需要根据实际需求修改 'server.py' 文件，实现更有意义的工具功能。

关键词