使用说明
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:
- 使用登录 GitHub 或 谷歌
- 通过仪表板添加您的网站(我的网站→ 添加服务)
- 首选 连接 page——为您的AI客户端生成配置
- 将配置复制粘贴到Claude Desktop、VS Code或Claude Code中
您的个人MCP端点: https://mcp.example.com/u/{your-user-id}/{alias}/mcp
配置您的网站
网站通过 网络仪表盘 --不需要环境变量。
- 集
MASTER_API_KEY在你的.env文件 - 启动服务器并打开仪表板
- 添加带有凭据(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客户端:
- 部署MCP集线器
OAUTH_BASE_URL集 - 在ChatGPT中,添加MCP服务器:
https://your-server:8000/mcp - 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许可证。看 许可证.
