Multi-MCP AI Agent

Multi-MCP AI Agent

一种 Agentic AI Agent 系统，通过利用多个 MCP（Model Control Protocol）服务提供广泛的能力，从基本的数学运算到 Google Workspace 和网页抓取等高级外部服务集成。该 Agent 包含 Telegram 机器人界面和用于实时通信的服务器发送事件（SSE）。

🌟 功能

• 多 MCP 架构：利用多个 MCP 服务进行分布式处理，并提供多样化的能力
• 认知模块：实现感知、决策、记忆和行动模块
• 外部服务集成：
  • Google Workspace（Gmail、Google Drive、Google Sheets）
  • 网页抓取和内容提取
  • DuckDuckGo 搜索集成
• 实时通信：
  • Telegram 机器人界面
  • 用于实时更新的服务器发送事件（SSE）
• 核心组件：
  • Agent 循环管理
  • 会话处理
  • 上下文管理
  • 战略决策

🏗️ 项目结构

├── agent.py              # Main agent entry point
├── core/                 # Core agent components
│   ├── context.py        # Context management
│   ├── loop.py           # Main agent loop
│   ├── session.py        # Session handling
│   └── strategy.py       # Strategic decision making
├── modules/              # Cognitive modules
│   ├── action.py         # Action execution
│   ├── decision.py       # Decision making
│   ├── memory.py         # Memory management
│   ├── model_manager.py  # Model management
│   ├── perception.py     # Input processing
│   └── tools.py          # Tool definitions
├── config/               # Configuration files
│   ├── models.json       # Model configurations
│   └── profiles.yaml     # MCP server profiles
└── mcp_server_*.py       # MCP server implementations

🚀 开始使用

前置条件

• Python 3.11+
• UV 包管理器
• Telegram Bot Token（用于机器人功能）
• Google Cloud 凭据（用于集成 Google Workspace）

安装

1. 克隆代码库：

git clone <repository-url>
cd <repository-name>

2. 创建并激活虚拟环境：

uv venv
venv\Scripts\activate  # On Mac: source venv/bin/activate

3. 使用 UV 安装依赖项：

uv sync

4. 设置环境变量：
   • 创建 .env，其中包含 Gemini API 密钥和 Telegram Bot Token。
   • 使用 Google OAuth 客户端生成 credentials.json。

配置

1. 在 config/profiles.yaml 中配置 MCP 服务
2. 在 config/models.json 中设置模型配置
3. 配置 Google Cloud 凭据：
   • 将 credentials.json 放在根目录中
   • 运行一次应用以生成 token.json

🎮 使用方法

启动 Agent

uv run agent.py

启动 Telegram Bot 服务

uv run telegram_sse_server.py

🛠️ MCP 服务

MCP 服务 1：基本操作

• 数学运算
• 图像处理
• 文件操作

MCP 服务 2：文档处理

• 文档索引
• 语义搜索
• 内容提取
• 图像说明生成

MCP 服务 3：网页集成

• DuckDuckGo 搜索
• 网页内容获取
• 请求速率限制

MCP 服务 4：Google Workspace

• Gmail 集成
• Google Sheets 操作
• Google Drive 管理
• F1 排名获取器（URL 抓取器）

📡 通信

Telegram 机器人

• 命令处理
• 消息处理
• 实时响应

SSE 服务端

• 实时事件流
• 客户端连接管理
• 事件广播

🧠 认知架构

该 Agent 实现了以下模块组成的认知架构：

• 感知：处理输入并提取相关信息
• 记忆：管理状态和历史数据
• 决策：根据输入和上下文做出战略决策
• 行动：通过适当的工具执行已决定的操作

📝 许可证

MIT 许可证