Mymcpserv

🚀 現代控制協議（MCP）服務器

現代控制協議（MCP）服務器是一個具備高度擴展性的實現方案，它支持多個AI提供方，擁有高級監控功能和強大的對話管理能力，能有效滿足多樣化的業務需求。

🚀 快速開始

克隆倉庫

首先，將項目倉庫克隆到本地。

複製環境變量模板

cp .env.example .env

更新環境變量

更新 .env 文件中的環境變量，以適配你的運行環境。

使用 Docker Compose 啟動服務

docker-compose up -d

✨ 主要特性

• 多提供方 AI 支持：支持 OpenAI、Anthropic、Google AI、Azure 等多個 AI 提供方。
• 即時流式響應：實現即時的流式響應，提升交互體驗。
• 對話管理和歷史記錄：具備完善的對話管理功能和歷史記錄保存能力。
• 函數調用和工具使用：支持函數調用和工具使用，增強功能擴展性。
• 向量數據庫集成：集成向量數據庫，優化數據存儲和檢索。
• 語義緩存：採用語義緩存技術，提高系統性能。
• Prometheus 指標與 Grafana 儀表盤：通過 Prometheus 指標和 Grafana 儀表盤實現高級監控。
• 速率限制和錯誤處理：具備速率限制和錯誤處理機制，保障系統穩定運行。
• PostgreSQL 數據持久化：使用 PostgreSQL 進行數據持久化。
• Redis 緩存：利用 Redis 進行緩存，提升數據訪問速度。
• Elasticsearch 搜索：藉助 Elasticsearch 提供強大的搜索功能。
• Docker 容器化：支持 Docker 容器化部署，方便快捷。

📚 詳細文檔

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。