MCP Server

基本能力

产品定位

MCP Server 是一个中间件服务器，旨在为大型语言模型 (LLMs) 提供标准化的外部工具和服务交互能力。

核心功能

• 支持多种工具（计算器、天气、搜索）
• 基于 FastAPI 的 RESTful API
• 使用 Pydantic 进行数据验证
• 高效的异步处理
• 自动生成 Swagger UI API 文档

适用场景

• 需要将 LLMs 与外部工具集成的开发项目
• 快速构建标准化 API 服务的场景
• 需要自动化工具调用的应用

工具列表

1. Calculator: 执行基本数学运算（加法和乘法）
2. Weather: 获取指定地点的天气信息
3. Search: 执行网络搜索

常见问题解答

• API 文档可通过访问 http://localhost:8000/docs 查看
• 添加新工具需要修改 SUPPORTED_TOOLS 和 process_tool_request 函数

使用教程

使用依赖

• Python 3.8+
• pip (Python 包管理器)

安装教程

1. 克隆仓库:

git clone <repository-url>
cd mcp-server

1. 创建并激活虚拟环境:

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

1. 安装必要的库:

pip install -r requirements.txt

调试方式

1. 启动服务器:

python main.py

1. 服务器将运行在: http://localhost:8000
2. 测试 API 端点:
3. GET / - 获取服务器信息和支持的工具列表
4. POST /execute - 执行指定工具

API 端点

1. 根端点

• URL: /
• 方法: GET
• 描述: 返回服务器信息和支持的工具列表

2. 执行工具

• URL: /execute
• 方法: POST
• 描述: 使用提供的参数执行工具
• 请求体:

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

许可证

该项目遵循 MIT 开源许可条款。