MCP Agent
2025.04.18
0
TypeScript智能对话代理外部服务集成交流协作开发效率
MCP Agent 是一个基于 Web 的对话代理，由 Google Gemini 提供支持，能够通过 Model Context Protocol (MCP) 服务器与各种外部服务进行交互。它提供了一个聊天界面，用户可以与 Google Gemini 进行对话，代理能够理解需要与外部工具（MCP 服务器）交互的请求并执行这些操作。
View on GitHub
Overview
基本能力
产品定位
MCP Agent 是一个智能对话代理，旨在通过集成多种外部服务（如 WhatsApp、GitHub、GSuite 等）来扩展 Google Gemini 的功能，使其能够执行更复杂的任务。
核心功能
- 对话交互：用户可以通过聊天界面与 Google Gemini 进行自然语言交互。
- 外部服务集成：通过 MCP 服务器与 WhatsApp、GitHub、GSuite 等服务进行交互。
- 动态系统提示：根据连接的服务器和可用工具生成动态提示。
- 功能调用：支持 Gemini 功能调用，执行 MCP 服务器命令。
- JSON-RPC 通信：通过 stdio 使用 JSON-RPC 与 MCP 服务器通信。
适用场景
- 自动化任务：如发送 WhatsApp 消息、管理 GitHub 问题、查询 GSuite 日历等。
- 开发辅助：通过集成开发工具（如 GitHub）提高开发效率。
- 协作工具：集成交流工具（如 WhatsApp）和协作平台（如 GSuite）以增强团队协作。
工具列表
- WhatsApp MCP Server：用于发送消息、列出聊天记录、搜索联系人等。
- GitHub MCP Server：用于管理 GitHub 仓库、问题等。
- GSuite MCP Server：用于查询日历、搜索邮件等。
常见问题解答
- 如何调试：检查终端日志，使用 MCP Inspector 调试 stdio 通信。
- 环境变量配置：确保所有必需的环境变量已正确设置。
- OAuth2 配置：验证 GSuite 的 OAuth2 凭证是否配置正确。
使用教程
使用依赖
- Node.js：LTS 版本推荐。
- npm 或 yarn：包管理工具。
- uv：Python 包管理器。
- Docker：用于 GitHub MCP 服务器。
- Google Gemini API Key：从 Google AI Studio 获取。
- GitHub Personal Access Token (PAT)：创建具有适当范围的 PAT。
- GSuite OAuth2 Credentials：配置 Google Cloud 项目并启用相关 API。
安装教程
- 克隆仓库：
bash git clone <repository_url> cd mcp-agent - 安装 Next.js 应用依赖：
bash cd mcp-agent-app npm install - 配置环境变量：
- 创建
.env.local文件并添加 API 密钥和配置路径。
调试方式
- 启动 WhatsApp Go bridge：
bash cd whatsapp-mcp/whatsapp-bridge go run main.go - 启动 GSuite MCP 服务器：
bash cd mcp-gsuite uv run mcp-gsuite --gauth-file .gauth.json --accounts-file .accounts.json --credentials-dir gsuite-credentials - 启动 Next.js 开发服务器：
bash cd mcp-agent-app npm run dev - 打开浏览器访问
http://localhost:3000。