MCP 服务器

MCP 服务器是一个模型上下文协议 (MCP) 的实现服务器，它允许大型语言模型 (LLMs) 以标准化的方式与外部工具和服务进行交互。

功能

• 支持多种工具（计算器、天气、搜索）
• 基于 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. 计算器

• 执行基本计算
• 参数:
  • operation: "add" 或 "multiply"
  • numbers: 需要计算的数字数组

2. 天气

• 获取某个地点的天气信息
• 参数:
  • location: 地点名称

3. 搜索

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

API 文档

访问 http://localhost:8000/docs 以查看使用 Swagger UI 生成的完整 API 文档。

开发

添加新工具

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

运行测试

pytest

许可证

MIT 许可证