AI原生管理平台

MCP Hub是一个AI原生的管理平台,用于通过AI助手管理WordPress、WooCommerce和其他自托管服务,提供多站点管理、AI代理集成和自动化工作流。

  • by airano-ir
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 airano-ir/mcphub

使用说明

MCP集线器

WordPress、WooCommerce和自托管服务的人工智能原生管理中心。

连接您的网站、商店、仓库和数据库——通过Claude、ChatGPT、Cursor或任何MCP客户端管理它们。


为什么选择MCP Hub?

WordPress支持43%的网络。WooCommerce运营着36%的在线商店。然而 不存在MCP服务器 通过人工智能管理它们——直到现在。

MCP Hub是第一个允许您通过任何AI助手管理WordPress、WooCommerce和其他8个自托管服务的MCP服务器。与其点击仪表板,不如告诉你的AI该做什么:

“更新所有没有SEO元描述的WooCommerce产品的SEO元描述”

“创建一篇关于我们黑色星期五促销的新博客文章,并安排在下周一”

“检查所有12个WordPress网站的运行状况,并报告任何响应时间慢的网站”

是什么让MCP Hub与众不同

功能 ManageWP MainWP AI内容插件 MCP集线器
多站点管理 是 是 否 是
AI代理集成 否 否 无 本地(MCP)
完整的WordPress API 仪表板 仪表板 Content only 67工具
WooCommerce管理 否 有限 否 28工具
Git/CI管理 否 否 不 65工具(Gitea)
自动化工作流 否 否 无 56个工具(n8n)
自托管 否 是 不适用 是
开源 否 仅限核心 各不相同 完全开放
价格 0.70-8/站点/月 29-79/年 19-79/月 自由

8个公共插件,数百种工具

随着新插件的发布和现有插件获得端点,确切的工具数量也在增长。 你实际暴露的内容是由你的 ENABLED_PLUGINS 设置和按键 scope——选择一个特定于插件的端点,以保持较小的表面积。

插件 近似工具 你能做什么
WordPress ~70 帖子、页面、媒体(包括AI图像生成)、用户、菜单、分类、SEO(排名数学/Yoast)
WooCommerce ~30 产品、订单、客户、优惠券、报告、发货
WordPress专家 ~50 插件、主题、用户、选项、cron、页面编辑、站点配置+布局、数据库检查、批量扇出(配套支持;无Docker套接字)
吉塔阿 ~65 转发、问题、拉取请求、发布、Webhook、组织、标签、批处理文件、树、搜索、比较
n8n ~55 工作流、执行、凭据、变量、审计
Supabase ~70 数据库、身份验证、存储、边缘功能、实时
OpenPanel ~40 事件、导出、见解、简介、项目、系统
冷却 ~65 应用程序、部署、服务器、项目、数据库、服务
系统 ~25 运行状况监视、API密钥、OAuth管理、审核

每个站点的重复确实如此 不 增加刀具数量——增加一秒 WordPress网站使用不同的WordPress工具重用相同的WordPress工具 site 争论。


快速开始

选项1:Docker(推荐)

git clone https://github.com/airano-ir/mcphub.git
cd mcphub
cp env.example .env
# Edit .env — set MASTER_API_KEY, then add sites via the web dashboard
docker compose up -d

选项2:Docker Hub(无克隆)

# Create a .env file with MASTER_API_KEY (see "Configure Your Sites" below)
docker run -d --name mcphub -p 8000:8000 --env-file .env airano/mcphub:latest

选项3:来源

git clone https://github.com/airano-ir/mcphub.git
cd mcphub
pip install -e .
cp env.example .env
# Edit .env — set MASTER_API_KEY
python server.py --transport streamable-http --port 8000

验证它是否有效

启动服务器后,等待约30秒,然后:

# Check server health
curl http://localhost:8000/health

打开 网络仪表盘 在浏览器中: http://localhost:8000/dashboard

您应该看到登录页面。使用您的账号登录 MASTER_API_KEY 或通过 GitHub/谷歌OAuth (如果已配置)。

立即尝试(无需设置)

不想自己主持? 在以下位置使用托管实例 mcp.example.com:

  1. 使用登录 GitHub 或 谷歌
  2. 通过仪表板添加您的网站(我的网站→ 添加服务)
  3. 首选 连接 page——为您的AI客户端生成配置
  4. 将配置复制粘贴到Claude Desktop、VS Code或Claude Code中

您的个人MCP端点: https://mcp.example.com/u/{your-user-id}/{alias}/mcp


配置您的网站

网站通过 网络仪表盘 --不需要环境变量。

  1. 集 MASTER_API_KEY 在你的 .env 文件
  2. 启动服务器并打开仪表板
  3. 添加带有凭据(URL、用户名、密码/令牌)的网站
# .env — only system configuration needed
MASTER_API_KEY=your-secure-key-here
Full Environment Variable Reference

系统配置:

变量 必填 默认 描述
MASTER_API_KEY 推荐 自动生成 用于管理员访问的主API密钥
LOG_LEVEL 没有 INFO 日志记录级别(调试、信息、警告、错误)
ENCRYPTION_KEY 用于实时平台 -- AES-256-GCM密钥,用于凭证加密
OAUTH_JWT_SECRET_KEY 对于OAuth -- JWT secret,用于ChatGPT自动注册(Claude/Cursor不需要)
OAUTH_BASE_URL 对于OAuth -- 服务器的公共URL(Claude/Cursor不需要)

OAuth 仅需要ChatGPT远程MCP自动注册。对于Claude Desktop、Claude Code、Cursor和VS Code,只需使用 MASTER_API_KEY 使用Bearer令牌身份验证。

插件凭据引用 --通过仪表板添加网站时,您需要:

插件 必需凭据 备注
WordPress URL、用户名、应用密码 如何创建应用程序密码
WooCommerce URL、消费者密钥、消费者秘密 WooCommerce→ 设置→ 高级→ REST API
WordPress专家 URL、用户名、应用密码 需要 Airano MCP桥接器v2.18.0+ 在WP网站上;用户必须具有 manage_options
Gitea URL,令牌 设置→ 应用程序→ 个人访问令牌
n8n URL,API密钥 设置→ API → 创建API密钥
Supabase URL,服务角色键 Supabase仪表板→ 设置→ API
OpenPanel URL、客户端ID、客户端密码 OpenPanel仪表板→ 项目设置

连接您的AI客户端

所有MCP客户端都使用 持有者令牌 身份验证: Authorization: Bearer YOUR_API_KEY

使用插件特定的端点(例如。, /wordpress/mcp)而不是 /mcp 以减少工具数量并节省令牌。看 建筑 在......下面

Claude Desktop

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "mcphub-wordpress": {
      "type": "streamableHttp",
      "url": "http://your-server:8000/wordpress/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Claude Code

添加 .mcp.json 在您的项目中:

{
  "mcpServers": {
    "mcphub-wordpress": {
      "type": "http",
      "url": "http://your-server:8000/wordpress/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Cursor

首选 设置>MCP服务器>添加服务器:

  • 名称:MCP Hub WordPress
  • 统一资源定位符: http://your-server:8000/wordpress/mcp
  • 标头: Authorization: Bearer YOUR_API_KEY
VS Code + Copilot

添加 .vscode/mcp.json:

{
  "servers": {
    "mcphub-wordpress": {
      "type": "http",
      "url": "http://your-server:8000/wordpress/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
ChatGPT (Remote MCP)

MCP集线器支持 开放式动态客户端注册 (RFC 7591)。ChatGPT可以自动注册为OAuth客户端:

  1. 部署MCP集线器 OAUTH_BASE_URL 集
  2. 在ChatGPT中,添加MCP服务器: https://your-server:8000/mcp
  3. ChatGPT自动发现OAuth元数据并注册

运输类型:使用 "type": "streamableHttp" 克劳德桌面和 "type": "http" 对于VS代码/Claude代码。使用 "type": "sse" 将导致 400 Bad Request 错误。


建筑

/mcp                        → Admin endpoint (every enabled tool)
/system/mcp                 → System tools only
/wordpress/mcp              → WordPress tools
/woocommerce/mcp            → WooCommerce tools
/wordpress-specialist/mcp   → WordPress Specialist tools (companion-backed)
/gitea/mcp                  → Gitea tools
/n8n/mcp                    → n8n tools
/supabase/mcp               → Supabase tools
/openpanel/mcp              → OpenPanel tools
/coolify/mcp                → Coolify tools
/project/{alias}/mcp        → Per-project endpoint (auto-injects site)
/u/{user_id}/{alias}/mcp    → Per-user endpoint (hosted/OAuth users)

推荐:使用插件特定的端点,而不是所有工具 /mcp 管理端点,以保持AI客户端的工具窗口较小(以及您的令牌账单 较低)。

端点 用例
/u/{user_id}/{alias}/mcp 托管用户(OAuth登录)——单一服务
/project/{alias}/mcp 单站点工作流程(推荐)
/{plugin}/mcp 一项服务的多站点管理
/mcp 仅限管理和发现——每个启用的工具

安全

  • OAuth 2.1+PKCE (RFC 8414、7591、7636)具有Claude/ChatGPT的自动注册功能
  • 项目API密钥 具有范围权限(读/写/管理)
  • 速率限制:每位客户每天60分钟、1000小时、10000次
  • 符合GDPR的审计日志 具有自动敏感数据过滤功能
  • Web仪表板 具有实时健康监测功能(8页,EN/FA i18n)

兼容性说明:MCP集线器需要FastMCP 3.x(>=3.0.0,<4.0.0).v3.5.0中删除了旧的多端点服务器和ProjectManager。

WordPress插件要求

一些MCP Hub工具需要配套的WordPress插件:

工具 要求
SEO+能力/审计工具(wordpress_get_post_seo、能力探测、审计挂钩等) Airano MCP桥 (GitHub)+排名数学或Yoast SEO
WP-CLI工具(15个工具: wp_cache_*, wp_db_*等) Docker套接字+ CONTAINER config
WordPress专家(约50个工具:插件/主题/用户/选项/cron/页面编辑/站点配置+布局/数据库检查/批量扇出) Airano MCP桥接器v2.18.0+ (不需要Docker套接字)
OpenPanel分析集成 OpenPanel自托管 (下载 ZIP)
WooCommerce工具 您的WordPress网站上安装的WooCommerce插件

Docker套接字 传统WP-CLI工具需要15个助手 wordpress_wp_*).一切都在 wordpress_specialist 没有它也能工作。添加到你的docker compose:

volumes:
  - /var/run/docker.sock:/var/run/docker.sock:ro

设置 container 在仪表板中添加WordPress站点时,字段。如果没有Docker套接字,WP-CLI工具将返回“不可用”,但所有REST API工具都能正常工作。


文档

指南 说明
入门指南 完整设置演练
建筑 系统设计和模块参考
API密钥指南 API项目密钥管理
OAuth指南 Claude/ChatGPT的OAuth 2.1设置
Gitea指南 Gitea插件配置
部署指导 Docker和Coolify部署
故障排除 常见问题和解决方案
插件开发 构建自己的插件

发展

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format and lint
black . && ruff check --fix .

# Run server locally
python server.py --transport streamable-http --port 8000

支持这个项目

MCP Hub是免费和开源的。发展由社区捐款资助。

用加密货币捐款(NOWPayments) --全球性,无地域限制。

目标 每月 启用
基础设施 每月50美元 演示托管、CI/CD、域名
兼职维护 每月500美元 更新、安全补丁、问题分类
积极开发 每月2000美元 新插件、功能、社区支持

贡献

我们欢迎捐款!看 贡献.md 作为指导方针。

优先领域:

  • 新插件开发
  • 客户端设置指南
  • 工作流模板和示例
  • 测试覆盖范围扩展
  • 翻译(i18n)

许可证

MIT许可证。看 许可证.