项目简介

这是一个基于 'fastmcp' Python 库构建的 MCP 服务器示例。它展示了如何创建一个简单的 MCP 服务器，注册并托管工具，并通过标准协议与 MCP 客户端进行通信。此服务器包含一个用于演示的加法工具。

主要功能点

• 工具托管与提供: 注册并使 'add'（加法）工具可供客户端调用。
• MCP 协议支持: 通过 'fastmcp' 库实现 MCP 协议的请求处理（如工具列表查询、工具调用）。
• SSE 传输: 支持 Server-Sent Events (SSE) 作为与客户端通信的传输协议。
• 为 LLM 应用提供服务: 为连接的 LLM 客户端（如基于 MCP 的 Agent）提供工具执行能力。

安装步骤

要运行此 MCP 服务器，您需要安装 Python 3.7+ 和 'fastmcp' 库：

pip install fastmcp

服务器配置

此 MCP 服务器的运行方式及客户端连接信息如下（通常用于配置您的 MCP 客户端）：

{
  // 这是一个示例配置，用于指导 MCP 客户端如何启动或连接到此服务器
  "server name": "FastMCP Demo", // 建议的服务器名称，由服务器自身声明
  "command": "python",          // 用于启动服务器的命令 (例如: python)
  "args": [                     // 命令的参数列表
    "./mcp_demo/server.py"      // 启动服务器的脚本路径
  ],
  "transport": {                // 服务器支持的传输协议信息
    "type": "sse",              // 协议类型 (例如: "sse", "websocket", "stdio")
    "url": "http://127.0.0.1:8000/sse" // SSE 传输协议的连接 URL
  }
}

您需要先在终端中运行 'command' 和 'args' 指示的命令 ('python ./mcp_demo/server.py') 来启动服务器，然后配置您的 MCP 客户端连接到 'transport.url' ('http://127.0.0.1:8000/sse') 指定的地址。

基本使用方法

1. 打开终端，导航到仓库目录。
2. 运行服务器脚本：

   python ./mcp_demo/server.py
   

3. 服务器将在 'http://127.0.0.1:8000' 启动并监听 SSE 连接。您会看到类似 'Uvicorn running on http://127.0.0.1:8000' 的输出。
4. 启动一个配置为连接到此地址的 MCP 客户端（例如此仓库中的 'agent.py' 示例客户端），它将能够发现并调用此服务器提供的 'add' 工具。