Simple MCP Server

Simple MCP Server

使用 FastMCP 实现的精简版 Model Context Protocol（MCP）服务。本示例演示如何创建一个简单的 MCP 服务，Windsurf IDE 和 Claude 等客户端可以连接到该服务。

什么是 MCP？

Model Context Protocol（MCP）是一项将大模型与外部工具和数据源连接起来的标准。MCP 服务通过提供对专用工具、外部信息和服务的访问，扩展 AI 能力。

功能

• 支持 HTTP 和 stdio 两种传输方式
• HTTP 传输的简单身份验证中间件
• 工具实现示例
• 兼容 Windsurf IDE 和 Claude 等 MCP 客户端

前提条件

• Python 3.11+
• FastMCP - https://github.com/jlowin/fastmcp
• uv - https://docs.astral.sh/uv/

安装

1. 克隆此仓库：

   git clone https://github.com/rjmoggach/simple-mcp-server.git
   cd simple-mcp-server
   

2. 安装依赖项：

   uv sync
   

使用方法

你可以通过三种不同的模式运行服务：

同时使用两种传输方式（默认）

python run_server.py

这会在端口 9876 上启动 HTTP 服务，并同时启动 stdio 服务。

仅使用 HTTP 传输

python run_server.py --http-only

仅使用 stdio 传输

python run_server.py --stdio-only

可用工具

该服务提供以下示例工具：

1. hello_world - 简单的问候工具

   • 参数：
     • name（字符串，默认值："World"）：问候对象的名称
     • delay（整数，默认值：0）：可选延迟时间，单位为秒
   • 返回：问候消息

2. get_version - 返回服务版本信息

   • 返回：版本详情，包括服务名称和 API 版本

3. system_info - 返回基本系统信息

   • 返回：Python 版本和平台详情

连接到 AI 系统

Windsurf IDE 配置

将以下配置添加到 Windsurf IDE 设置中：

"simple-mcp": {
  "command": "npx",
  "args": [
    "mcp-remote", 
    "http://localhost:9876/", 
    "--allow-http", 
    "--header", 
    "Authorization: Bearer SIMPLE_MCP_SERVER"
  ]
}

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "simple-mcp": {
      "command": "uv",
      "args": [
        "run", 
        "--project", "/path/to/simple-mcp-server", 
        "python", "/path/to/simple-mcp-server/run_server.py", 
        "--stdio-only"
      ],
      "cwd": "/path/to/simple-mcp-server"
    }
  }
}

将 /path/to/simple-mcp-server 替换为你的项目实际路径。

身份验证

对于 HTTP 传输，服务使用简单的基于令牌的身份验证：

• 令牌：SIMPLE_MCP_SERVER（在 run_server.py 中定义）
• 标头格式：Authorization: Bearer SIMPLE_MCP_SERVER

扩展服务

要添加自己的工具，请修改 run_server.py 中的 create_mcp_server() 函数：

@mcp.tool()
async def your_custom_tool(param1: str, param2: int = 0) -> dict:
    """Your custom tool description."""
    # Implementation here
    return {"result": "Your output"}

许可证

MIT 许可证