MCP Agent 2p6

🚀 MCP 代理项目文档

MCP Agent 是一个多用途控制平台，它通过集成多种服务，为用户提供强大且丰富的功能。此文档会详细介绍该项目的结构、配置以及使用方法。

🚀 快速开始

1. 克隆项目仓库：

git clone https://github.com/yourusername/mcp-agent.git

2. 安装依赖：

cd mcp-agent/mcp-agent-app && npm install

3. 配置环境变量，填写 .env.local 文件。
4. 启动应用程序：

npm run dev

✨ 主要特性

MCP Agent 作为多用途控制平台，集成多种服务，具备强大功能。它通过前端应用处理用户交互和 API 请求，同时借助不同的配置文件定义服务器连接参数、工具 schema 以及 LLM 提供商和模型，为用户提供多样化的使用体验。

📦 安装指南

1. 克隆项目仓库：

git clone https://github.com/yourusername/mcp-agent.git

2. 安装依赖：

cd mcp-agent/mcp-agent-app && npm install

3. 配置环境变量，填写 .env.local 文件。
4. 启动应用程序：

npm run dev

📚 详细文档

项目组件

核心组件

• mcp-agent-app：基于 Next.js 的前端应用，负责处理用户交互和 API 请求。
• MCP 配置文件：定义了 MCP 服务器的连接参数和工具 schema。
• LLM 配置文件：为用户界面提供 LLM 提供商和模型的定义。

项目结构

mcp-agent/ (项目根目录)
├── .gitignore
├── LICENSE
├── README.md (本文件)
├── docs/ (额外文档)
├── mcp-agent-app/ (Next.js 应用程序)
│   ├── .env.local (API Key、路径、数据库 URL)
│   ├── llm-config.json (LLM 提供商/模型定义用于 UI)
│   ├── mcp-config.json (MCP 服务器命令配置)
│   ├── next.config.ts
│   ├── package.json
│   ├── prisma/
│   │   └── schema.prisma (数据库模式)
│   │   └── migrations/ (迁移文件)
│   ├── src/
│   │   ├── app/
│   │   │   ├── api/
│   │   │   │   ├── chat/route.ts (主聊天 API，使用 Vercel AI SDK)
│   │   │   │   └── chats/ (API 路由用于保存/加载聊天记录)
│   │   │   └── page.tsx (主页组件)
│   │   ├── components/ (React 组件：ChatInterface、Sidebar 等)
│   │   ├── context/
│   │   │   └── ChatContext.tsx (管理应用程序状态，集成 useChat 钩子)
│   │   └── lib/
│   │       └── prisma.ts (Prisma 客户端实例)
│   └── ... (其他 Next.js 文件)
├── duckduckgo-mcp-server/ (DuckDuckGo 搜索 MCP 服务器源代码)
├── github-mcp-server/ (GitHub MCP 服务器源代码，若使用 Docker 镜像则无需直接运行)
├── mcp-gsuite/ (GSuite MCP 服务器源代码)
└── whatsapp-mcp/
    ├── whatsapp-bridge/ (Go 组件 - 需要单独执行)
    └── whatsapp-mcp-server/ (Python 组件)

配置文件说明

.env.local 文件

该文件用于存储项目运行所需的环境变量，包括：

• API Key：用于访问各种服务（如 GitHub、GSuite）的密钥。
• 路径配置：指定各 MCP 服务器组件的位置。
• 数据库 URL：定义应用程序连接的数据库地址。

llm-config.json 文件

此文件为用户界面提供 LLM 提供商和模型的详细信息，便于选择和配置。

mcp-config.json 文件

该文件定义了各个 MCP 服务器的连接参数，包括：

• id：唯一标识符。
• description：简要说明。
• command：执行命令，包含可选参数和环境变量设置。

当前 MCP 服务器实现

WhatsApp MCP 服务器

• 源代码位置：whatsapp-mcp/
• 执行方式：通过 Go 组件和 Python 脚本运行。
• 功能：处理 WhatsApp 消息和交互。

GitHub MCP 服务器

• 源代码位置：github-mcp-server/
• 执行方式：基于 Docker 镜像运行。
• 功能：集成 GitHub API，实现自动化操作。

GSuite MCP 服务器

• 源代码位置：mcp-gsuite/
• 执行方式：直接运行 Python 脚本。
• 功能：管理 Google Workspace 服务。

DuckDuckGo 搜索 MCP 服务器

• 源代码位置：duckduckgo-mcp-server/
• 执行方式：通过 HTTP 请求调用。
• 功能：提供网络搜索结果。

添加新 MCP 服务器

要添加新的 MCP 服务器，请按照以下步骤操作：

1. 更新 mcp-config.json 文件：
   • 添加新的服务器条目，包含其唯一标识符和描述。
   • 配置执行命令，包括可选参数和环境变量。
2. 实现服务器组件：
   • 根据需求编写代码，确保兼容现有架构。
   • 提供详细的文档说明功能和配置方式。
3. 测试和集成：
   • 确保新服务器与主应用程序正常通信。
   • 处理所有潜在的依赖关系和错误情况。

🔧 技术细节

MCP 代理协议（JSON-RPC）

MCP 使用 JSON-RPC 协议进行通信，具体接口定义如下：

• 请求格式：

{
    "jsonrpc": "2.0",
    "method": "string",
    "params": "array",
    "id": "integer"
}

• 响应格式：

{
    "jsonrpc": "2.0",
    "result": "object",
    "id": "integer"
}

数据库结构

• 聊天记录表：chat_records
  • id: 整数，主键。
  • content: 文本，存储聊天内容。
  • timestamp: 时间戳，记录创建时间。

🤝 贡献指南

欢迎社区贡献！请在提交 PR 前阅读 CONTRIBUTING.md 文件，了解代码规范和提交流程。

📄 许可证

项目遵循 MIT 许可证。详细信息请查看 LICENSE 文件。

⚠️ 重要提示

本文档持续更新中，更多细节请关注后续版本发布。