MCP Server

MCP 服务

MCP 服务是一个实现 Model Context Protocol（MCP）的服务器，可让大语言模型（LLM）以标准化的方式与外部工具和服务交互。

功能

• 支持多种工具（calculator、weather、search）
• 使用 FastAPI 提供 RESTful API
• 使用 Pydantic 验证数据
• 高效处理异步任务
• 使用 Swagger UI 自动生成 API 文档

系统要求

• Python 3.8+
• pip（Python 包管理器）

安装

1. 克隆仓库：

git clone <repository-url>
cd mcp-server

2. 创建并激活虚拟环境：

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

3. 安装所需库：

pip install -r requirements.txt

运行服务

python main.py

服务将在以下地址运行：http://localhost:8000

API 端点

1. 根端点

• URL：/
• Method：GET
• Description：返回服务信息和支持的工具列表

2. 执行工具

• URL：/execute
• Method：POST
• Description：使用提供的参数执行工具
• Request Body：

{
  "tool_name": "calculator",
  "parameters": {
    "operation": "add",
    "numbers": [1, 2, 3]
  },
  "context": {}
}

支持的工具

1. Calculator

• 执行基本计算
• 参数：
  • operation：“add”或“multiply”
  • numbers：要计算的数字数组

2. Weather

• 获取指定地点的天气信息
• 参数：
  • location：地点名称

3. Search

• 执行网络搜索
• 参数：
  • query：搜索关键词

API 文档

访问 http://localhost:8000/docs，通过 Swagger UI 查看完整的 API 文档。

开发

添加新工具

1. 将工具名称和描述添加到 SUPPORTED_TOOLS
2. 在 process_tool_request 中添加新的处理函数
3. 为新工具创建专用处理函数

运行测试

pytest

许可证

MIT 许可证