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 文件。

⚠️ 重要提示

本文檔持續更新中，更多細節請關注後續版本發佈。