MCP服务器多代理AI基础设施

一个全面的基础设施，用于支持由专门的模型上下文协议（MCP）服务器驱动的多代理AI集群。此单体仓库包含编排、连接和增强具有各种专门能力的智能代理所需的完整组件堆栈。

🌟 概述

该项目能够创建一个多代理AI生态系统，其中专门的代理可以通过模型上下文协议（MCP）进行协作、共享上下文并利用不同的能力。通过提供标准化的通信层，代理可以通过统一的协议无缝访问向量数据库、专用工具和各种数据源。

该基础设施支持：

• 通过向量嵌入进行语义搜索和检索
• 多代理协作和通信
• 模块化、基于微服务的架构
• 代理交互的可视化检查和调试
• 用于AI能力的可扩展工具框架

🧩 核心组件

Inspector

一个用于监控、测试和调试MCP服务器的交互式仪表板。使用React/Vite前端和Express后端构建。

• 位于：/inspector
• 特点：
  • 实时连接到任何MCP服务器
  • 可用工具的交互式探索
  • 测试提示和工具调用
  • 监控代理交互
  • 调试服务器响应和行为

集成MCP的Qdrant-DB

使用Qdrant的向量数据库实现，具有完整的MCP服务器集成，为AI代理启用语义搜索功能。

• 位于：/qdrant-db
• 特点：
  • 用于语义相似性搜索的向量嵌入
  • 带有元数据的文档存储
  • 用于高级操作的Python客户端
  • 用于高效嵌入的FastEmbed集成
  • 与MCP生态系统的无缝连接

MCP Docker网络

用于在统一网络中编排和连接MCP服务的基础设施。

• 位于：/mcp-docker-network
• 特点：
  • 用于安全服务通信的隔离网络
  • 用于容器编排的管理工具
  • 集群内的服务发现
  • 简化复杂代理系统的部署

🚀 快速开始

前提条件

• Docker和Docker Compose
• Node.js（用于本地开发）
• Python 3.9+（用于运行客户端和脚本）

快速启动

1. 克隆存储库：

   git clone https://github.com/FrankGenGo/mcp-servers.git
   cd mcp-servers
   

2. 设置共享的Docker网络：

   cd mcp-docker-network
   ./scripts/manage-network.sh create
   

3. 启动Qdrant向量数据库和MCP服务器：

   cd ../qdrant-db/qdrant_stack
   docker-compose up -d
   

4. 启动Inspector仪表板：

   cd ../../inspector
   docker build -t mcp-inspector .
   docker run -d --name mcp-inspector --network mcp-docker-network -p 5173:5173 -p 3000:3000 mcp-inspector
   

5. 在http://localhost:5173访问Inspector仪表板

🏗️ 架构

该项目实现了一个围绕模型上下文协议的分布式微服务架构：

┌───────────────┐     ┌───────────────┐     ┌───────────────┐
│   AI 代理    │     │  AI 代理     │     │  AI 代理     │
│  能力       │     │  推理       │     │  规划       │
└───────┬───────┘     └───────┬───────┘     └───────┬───────┘
        │                     │                     │
        │                     ▼                     │
        │             ┌───────────────┐             │
        └────────────►  MCP 网络   ◄─────────────┘
                     │ 通信          │
                     └───────┬───────┘
                             │
              ┌──────────────┴──────────────┐
              │                             │
    ┌─────────▼──────────┐        ┌─────────▼──────────┐
    │   Qdrant MCP       │        │  Inspector         │
    │   向量搜索       │        │  监控          │
    └────────────────────┘        └────────────────────┘

组件通过共享的Docker网络进行通信，其中：

• Inspector仪表板（端口5173）→ Express代理（端口3000）→ MCP服务器
• Qdrant MCP服务器（端口8000）→ Qdrant数据库（端口6333）
• 所有服务通过mcp-docker-network连接

🧠 用例

• 多代理系统：构建结合不同AI能力的协作代理系统
• 知识管理：创建具有直观AI界面的语义搜索系统
• 工具集成：使用专用工具和数据源扩展AI能力
• 开发与调试：在开发过程中检查和测试MCP服务器

🛠️ 开发

每个组件都可以独立开发：

• Inspector：带有Express后端的React/TypeScript前端
• Qdrant MCP服务器：Python FastMCP实现
• 网络管理：Bash脚本和Docker Compose配置

有关具体的开发说明，请参阅每个子目录中的README。

📚 更多资源

• 模型上下文协议规范
• MCP Python SDK
• MCP TypeScript SDK
• Qdrant 文档

📄 许可证

该项目根据MIT许可证获得许可 - 有关详细信息，请参阅LICENSE文件。