Model Context Protocol (MCP) Server

基本能力

产品定位

MCP-server 是一个为大型语言模型设计的上下文管理服务器，专注于文档和上下文的高效管理，支持异步任务处理和错误恢复。

核心功能

• 文档管理：创建、检索和删除文档对象
• 上下文管理：创建、更新、检索和删除上下文集合
• 异步任务处理：后台处理任务，具有错误隔离功能
• 速率限制：内置请求限制，防止过载
• 错误处理：失败的任务会被存储以便后续检查和重试
• API文档：自动生成的Swagger UI文档
• 简单认证：基于API密钥的安全性

适用场景

• 需要高效管理大量文档和上下文的语言模型应用
• 需要异步处理和错误恢复机制的系统
• 需要API文档和简单认证的开发者工具

工具列表

• Swagger UI：提供交互式API文档
• FastAPI：用于构建API的高性能框架
• Uvicorn：ASGI服务器，用于运行FastAPI应用
• Pydantic：数据验证和设置管理

常见问题解答

• 如何更改API密钥？：通过设置MCP_API_KEY环境变量来更改默认API密钥
• 如何更改服务器端口？：通过设置PORT环境变量来更改默认端口
• 如何处理失败的任务？：通过/tasks/failed端点查看失败任务，并通过/tasks/retry端点重试

使用教程

使用依赖

• Python 3.7+
• pip包管理器

安装教程

# 克隆仓库
git clone https://github.com/your-username/mcp-server.git
cd mcp-server

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# 安装依赖
pip install fastapi uvicorn pydantic

调试方式

python app.py

服务器默认在http://localhost:8000启动。访问http://localhost:8000/docs查看交互式API文档。

在VS Code中调试： 1. 在VS Code中打开项目文件夹 2. 确保安装了Python扩展 3. 选择Python解释器（虚拟环境中的解释器） 4. 打开终端并运行python app.py 5. 设置断点并按F5进行调试

许可证

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