该插件的主要代码已加入MaiBot主程序中，当前仓库不再更新

MCP 桥接插件

将 MCP (Model Context Protocol) 服务器的工具桥接到 MaiBot，使麦麦能够调用外部 MCP 工具。

🚀 快速开始

1. 安装

# 克隆到 MaiBot 插件目录
cd /path/to/MaiBot/plugins
git clone https://github.com/CharTyr/MaiBot_MCPBridgePlugin.git MCPBridgePlugin

# 安装依赖
pip install mcp

# 复制配置文件
cd MCPBridgePlugin
cp config.example.toml config.toml

2. 添加服务器

编辑 config.toml，在 [servers] 的 claude_config_json 中填写 Claude Desktop 的 mcpServers JSON：

[servers]
claude_config_json = '''
{
  "mcpServers": {
    "time": { "transport": "streamable_http", "url": "https://mcp.api-inference.modelscope.cn/server/mcp-server-time" },
    "my-server": { "transport": "streamable_http", "url": "https://mcp.xxx.com/mcp", "headers": { "Authorization": "Bearer 你的密钥" } },
    "fetch": { "command": "uvx", "args": ["mcp-server-fetch"] }
  }
}
'''

3. 启动

重启 MaiBot，或发送 /mcp reconnect

---

📚 去哪找 MCP 服务器？

---

💡 常用命令

---

✨ 功能特性

核心功能

• 🔌 多服务器同时连接
• 📡 支持 stdio / SSE / HTTP / Streamable HTTP
• 🔄 自动重试、心跳检测、断线重连
• 🖥️ WebUI 完整配置支持

双轨制架构

• 🔄 ReAct（软流程）：LLM 自主决策，多轮动态调用 MCP 工具（适合探索式场景）
• 🔗 Workflow（硬流程/工具链）：用户预定义步骤顺序与参数传递（适合可控可复用场景）

高级功能

• 📦 Resources 支持（实验性）
• 📝 Prompts 支持（实验性）
• 🔄 结果后处理（LLM 摘要提炼）
• 🔍 调用追踪 / 🗄️ 调用缓存 / 🔐 权限控制 / 🚫 工具禁用

更新日志

• 见 plugins/MaiBot_MCPBridgePlugin/CHANGELOG.md

---

⚙️ 配置说明

服务器配置

{
  "mcpServers": {
    "server_name": {
      "transport": "streamable_http",
      "url": "https://..."
    }
  }
}

权限控制

快捷配置（推荐）：

[permissions]
perm_enabled = true
quick_deny_groups = "123456789"      # 禁用的群号
quick_allow_users = "111111111"      # 管理员白名单

高级规则：

[{"tool": "mcp_*_delete_*", "denied": ["qq:123456:group"]}]

工具禁用

[tools]
disabled_tools = '''
mcp_filesystem_delete_file
mcp_filesystem_write_file
'''

调用缓存