mcp-multi-agent-server

Qoohsuan/mcp-multi-agent-server

3.2

If you are the rightful owner of mcp-multi-agent-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The MCP Multi-Agent Server is a system based on the Model Context Protocol (MCP) that supports multiple AI assistants to connect and control studio equipment, play music, perform calculations, and more.

Tools
3
Resources
0
Prompts
0

MCP Multi-Agent Server

基於 Model Context Protocol (MCP) 的多智能體管理系統，支援多個 AI 助理同時連接並控制工作室設備、播放音樂、執行計算等功能。

🌟 特色功能

  • 🤖 多智能體支援 - 同時管理多個 AI 助理，每個助理擁有獨立的身份和權限
  • 🔌 模組化架構 - 功能模組可獨立開發和維護
  • 🏠 IoT 設備控制 - 控制工作室燈光、風扇等智能設備
  • 🎵 音樂管理 - 音樂播放控制
  • 🔐 安全認證 - JWT Token 認證，資源鎖防止並發衝突
  • 🔄 自動重連 - 網路中斷時自動恢復連接

🏗️ 系統架構

智能體1          智能體2          智能體3
    ↓               ↓               ↓
 WebSocket       WebSocket       WebSocket
    ↓               ↓               ↓
         MCP Server (mcp_pipe.py)
                    ↓
         Studio Tools (模組化架構)
         ├─ Calculator Module
         ├─ IoT Control Module
         └─ Music Module

📋 核心組件

1. Multi-Agent Manager (multi_agent_manager.py)

多智能體生命週期管理器

  • 啟動/停止/監控智能體
  • 配置管理
  • 互動式命令列介面

2. MCP Pipe (mcp_pipe.py)

WebSocket 連接管道

  • 建立與小智平台的 WebSocket 連接
  • 雙向通訊處理
  • 自動重連機制

3. Studio Tools (studio_tools.py)

模組化 MCP 服務器

  • 整合所有功能模組
  • 統一工具註冊介面
  • 智能體身份識別

4. 功能模組 (modules/)

  • Calculator Module - 計算器功能
  • IoT Module - IoT 設備控制
  • Music Module - 音樂播放控制

🚀 快速開始

1. 安裝依賴

pip install -r requirements.txt

2. 配置環境

複製範例配置文件並填入你的資訊：

cp .env.example .env
cp agent_config.example.json agent_config.json

編輯 .env:

MCP_ENDPOINT=wss://api.xiaozhi.me/mcp/?token=YOUR_JWT_TOKEN
MCP_AGENT_ID=YOUR_AGENT_ID
MCP_AGENT_NAME=YOUR_AGENT_NAME

編輯 agent_config.json 並填入你的智能體配置。

3. 啟動服務

方式 1：使用多智能體管理器（推薦）
python3 multi_agent_manager.py

管理器提供以下功能：

  1. 查看所有配置的智能體
  2. 添加/移除智能體配置
  3. 啟動/停止單個智能體
  4. 批量啟動/停止所有智能體
  5. 實時監控智能體狀態
方式 2：手動啟動單個智能體
export MCP_ENDPOINT="wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN"
export MCP_AGENT_ID="YOUR_AGENT_ID"
export MCP_AGENT_NAME="YOUR_AGENT_NAME"
python3 mcp_pipe.py studio_tools.py

📚 詳細文檔

詳細的架構說明請參考：

🔧 可用工具

IoT 控制

  • studio_light_on - 開啟工作室燈光
  • studio_light_off - 關閉工作室燈光
  • studio_fan_on - 開啟工作室風扇
  • studio_fan_off - 關閉工作室風扇

計算器

  • calculator - 執行數學運算

音樂控制

  • 音樂播放管理功能

🛡️ 安全性

  • ✅ JWT Token 認證
  • ✅ 敏感資訊不提交至 Git（使用 .gitignore）
  • ✅ 進程隔離
  • ✅ 資源鎖機制防止並發衝突
  • ✅ 所有操作記錄智能體身份

🔐 重要提醒

⚠️ 絕對不要將包含真實 tokens 的配置文件提交到 Git！

已在 .gitignore 中排除：

  • .env
  • agent_config.json
  • voiceprint_permissions.json
  • logs/

📦 技術棧

  • Python 3
  • websockets - WebSocket 通訊
  • mcp - Model Context Protocol SDK
  • pydantic - 數據驗證
  • python-dotenv - 環境變數管理
  • requests - HTTP API 呼叫

📝 授權

請根據你的需求添加適當的授權條款。

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

📞 聯絡

如有問題或建議，請開啟 Issue。