现代控制协议（MCP）服务器

一个现代、可扩展的MCP服务器实现，支持多个AI提供方、高级监控以及强大的对话管理。

功能特性

• 多提供方AI支持（OpenAI、Anthropic、Google AI、Azure）
• 实时流式响应
• 对话管理和历史记录
• 函数调用和工具使用
• 向量数据库集成
• 语义缓存
• Prometheus指标与Grafana仪表盘
• 速率限制和错误处理
• PostgreSQL数据持久化
• Redis缓存
• Elasticsearch搜索
• Docker容器化

快速开始指南

1. 克隆仓库
2. 复制环境变量模板：

   cp .env.example .env
   

3. 更新.env文件中的环境变量
4. 使用Docker Compose启动服务：

   docker-compose up -d
   

API文档

服务器运行后，访问以下链接：

• API文档：http://localhost:8000/docs
• ReDoc文档：http://localhost:8000/redoc

监控信息

• Prometheus指标：http://localhost:9090
• Grafana仪表盘：http://localhost:3000

开发准备

先决条件

• Python 3.9+
• PostgreSQL数据库
• Redis缓存
• Elasticsearch搜索
• Docker及Docker Compose

本地开发环境搭建

1. 创建虚拟环境：

   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   # 或者
   .\venv\Scripts\activate  # Windows系统
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 启动开发服务器：

   uvicorn app.main:app --reload
   

测试

运行测试用例：

pytest

系统架构

MCP服务器采用微服务架构设计：

• 使用FastAPI构建REST API
• PostgreSQL用于数据持久化
• Redis用于缓存和速率限制
• Elasticsearch提供搜索功能
• Qdrant实现向量存储
• Prometheus与Grafana负责监控

API接口

• /api/v1/mcp/prompts：提示管理
• /api/v1/mcp/conversations：对话处理
• /api/v1/mcp/conversations/{id}/complete：AI完成请求
• /metrics：Prometheus指标
• /health：健康检查端点

授权协议

本项目采用MIT许可证，具体条款请参考MIT License。