MCP Server Cgb

🚀 MCP 服务器

MCP 服务器是基于 Model Context Protocol (MCP) 协议构建的服务器，它为大型语言模型（LLMs）与外部工具及服务的交互提供了标准化途径，极大提升了交互的便捷性与规范性。

🚀 快速开始

MCP 服务器允许大型语言模型（LLMs）与外部工具和外部服务以标准的方式进行交互。以下是启动服务器的步骤：

# 克隆仓库
git clone <repository-url>
cd mcp-server

# 创建并激活虚拟环境
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 安装所需的库
pip install -r requirements.txt

# 运行服务器
python main.py

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

✨ 主要特性

• 支持多种工具（计算器、天气、搜索），满足多样化需求。
• 基于 FastAPI 的 RESTful API，提供高效稳定的接口服务。
• 使用 Pydantic 进行数据验证，确保数据的准确性和完整性。
• 具备高效的异步处理能力，提升系统响应速度。
• 可自动生成 API 文档（带有 Swagger UI），方便开发人员查看和使用。

📦 安装指南

系统要求

• 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

💻 使用示例

基础用法

启动服务器后，可通过 API 端点与服务器进行交互。例如，访问根端点获取服务器信息和受支持工具的列表：

curl http://localhost:8000

高级用法

使用 /execute 端点执行工具，以下是一个执行计算器工具的示例：

curl -X POST "http://localhost:8000/execute" -H "Content-Type: application/json" -d '{
    "tool_name": "calculator",
    "parameters": {
        "operation": "add",
        "numbers": [1, 2, 3]
    },
    "context": {}
}'

📚 详细文档

API 端点

1. 根端点

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

2. 执行工具

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

{
    "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 查看完整的 API 文档，带有 Swagger UI。

🔧 技术细节

开发

添加新工具

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

运行测试

pytest

📄 许可证

本项目采用 MIT License。