# MCP Hub
**The AI-native management hub for WordPress, WooCommerce, and self-hosted services.** Connect your sites, stores, repos, and databases — manage them all through Claude, ChatGPT, Cursor, or any MCP client. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776ab.svg)](https://www.python.org/) [![Tests: 164 passing](https://img.shields.io/badge/tests-164%20passing-brightgreen.svg)]() [![Tools: 587](https://img.shields.io/badge/tools-587-orange.svg)]()
--- ## Why MCP Hub? WordPress powers 43% of the web. WooCommerce runs 36% of online stores. Yet **no MCP server existed** for managing them through AI — until now. MCP Hub is the first and only MCP server that lets you manage WordPress, WooCommerce, and 7 other self-hosted services through any AI assistant. Instead of clicking through dashboards, just tell your AI what to do: > *"Update the SEO meta description for all WooCommerce products that don't have one"* > > *"Create a new blog post about our Black Friday sale and schedule it for next Monday"* > > *"Check the health of all 12 WordPress sites and report any with slow response times"* ### What Makes MCP Hub Different | Feature | ManageWP | MainWP | AI Content Plugins | **MCP Hub** | |---------|----------|--------|---------------------|-------------| | Multi-site management | Yes | Yes | No | **Yes** | | AI agent integration | No | No | No | **Native (MCP)** | | Full WordPress API | Dashboard | Dashboard | Content only | **65 tools** | | WooCommerce management | No | Limited | No | **28 tools** | | Git/CI management | No | No | No | **56 tools (Gitea)** | | Automation workflows | No | No | No | **56 tools (n8n)** | | Self-hosted | No | Yes | N/A | **Yes** | | Open source | No | Core only | Varies | **Fully open** | | Price | $0.70-8/site/mo | $29-79/yr | $19-79/mo | **Free** | --- ## 587 Tools Across 9 Plugins | Plugin | Tools | What You Can Do | |--------|-------|-----------------| | **WordPress** | 65 | Posts, pages, media, users, menus, taxonomies, SEO (Rank Math/Yoast) | | **WooCommerce** | 28 | Products, orders, customers, coupons, reports, shipping | | **WordPress Advanced** | 22 | Database ops, bulk operations, WP-CLI, system management | | **Gitea** | 56 | Repos, issues, pull requests, releases, webhooks, organizations | | **n8n** | 56 | Workflows, executions, credentials, variables, audit | | **Supabase** | 70 | Database, auth, storage, edge functions, realtime | | **OpenPanel** | 73 | Events, funnels, profiles, dashboards, projects | | **Appwrite** | 100 | Databases, auth, storage, functions, teams, messaging | | **Directus** | 100 | Collections, items, users, files, flows, permissions | | **System** | 17 | Health monitoring, API keys, project discovery | | **Total** | **587** | Constant count — scales to unlimited sites | --- ## Quick Start ### Option 1: Docker (Recommended) ```bash git clone https://github.com/mcphub/mcphub.git cd mcphub cp env.example .env # Edit .env with your site credentials docker compose up -d ``` ### Option 2: Python ```bash git clone https://github.com/mcphub/mcphub.git cd mcphub pip install -e . cp env.example .env # Edit .env with your site credentials python server.py --transport sse --port 8000 ``` ### Configure Your Sites Add site credentials to `.env`: ```bash # Master API Key (required) MASTER_API_KEY=your-secure-key-here # WordPress Site WORDPRESS_SITE1_URL=https://myblog.com WORDPRESS_SITE1_USERNAME=admin WORDPRESS_SITE1_APP_PASSWORD=xxxx xxxx xxxx xxxx WORDPRESS_SITE1_ALIAS=myblog # WooCommerce Store WOOCOMMERCE_STORE1_URL=https://mystore.com WOOCOMMERCE_STORE1_CONSUMER_KEY=ck_xxxxx WOOCOMMERCE_STORE1_CONSUMER_SECRET=cs_xxxxx WOOCOMMERCE_STORE1_ALIAS=mystore # Gitea Instance GITEA_REPO1_URL=https://git.example.com GITEA_REPO1_TOKEN=your_gitea_token GITEA_REPO1_ALIAS=mygitea ``` ### Connect Your AI Client
Claude Desktop Add to `claude_desktop_config.json`: ```json { "mcpServers": { "mcphub": { "url": "https://your-server:8000/mcp", "headers": { "Authorization": "Bearer YOUR_MASTER_API_KEY" } } } } ```
Claude Code Add to `.mcp.json` in your project: ```json { "mcpServers": { "mcphub": { "type": "sse", "url": "https://your-server:8000/mcp", "headers": { "Authorization": "Bearer YOUR_MASTER_API_KEY" } } } } ```
Cursor Go to **Settings > MCP Servers > Add Server**: - **Name**: MCP Hub - **URL**: `https://your-server:8000/mcp` - **Headers**: `Authorization: Bearer YOUR_MASTER_API_KEY`
VS Code + Copilot Add to `.vscode/mcp.json`: ```json { "servers": { "mcphub": { "type": "sse", "url": "https://your-server:8000/mcp", "headers": { "Authorization": "Bearer YOUR_MASTER_API_KEY" } } } } ```
ChatGPT (Remote MCP) MCP Hub supports **Open Dynamic Client Registration** (RFC 7591). ChatGPT can auto-register as an OAuth client: 1. Deploy MCP Hub with `OAUTH_BASE_URL` set 2. In ChatGPT, add MCP server: `https://your-server:8000/mcp` 3. ChatGPT auto-discovers OAuth metadata and registers
--- ## Architecture ``` /mcp → Admin endpoint (all 587 tools) /system/mcp → System tools only (17 tools) /wordpress/mcp → WordPress tools (65 tools) /woocommerce/mcp → WooCommerce tools (28 tools) /gitea/mcp → Gitea tools (56 tools) /n8n/mcp → n8n tools (56 tools) /supabase/mcp → Supabase tools (70 tools) /openpanel/mcp → OpenPanel tools (73 tools) /appwrite/mcp → Appwrite tools (100 tools) /directus/mcp → Directus tools (100 tools) /project/{alias}/mcp → Per-project endpoint (auto-injects site) ``` **Multi-endpoint architecture**: Give each team member or AI agent access to only the tools they need. ### Security - **OAuth 2.1 + PKCE** (RFC 8414, 7591, 7636) with auto-registration for Claude/ChatGPT - **Per-project API keys** with scoped permissions (read/write/admin) - **Rate limiting**: 60/min, 1,000/hr, 10,000/day per client - **GDPR-compliant audit logging** with automatic sensitive data filtering - **Web dashboard** with real-time health monitoring (8 pages, EN/FA i18n) --- ## Documentation | Guide | Description | |-------|-------------| | [Getting Started](docs/getting-started.md) | Full setup walkthrough | | [Architecture](docs/ARCHITECTURE.md) | System design and module reference | | [API Keys Guide](docs/API_KEYS_GUIDE.md) | Per-project API key management | | [OAuth Guide](docs/OAUTH_GUIDE.md) | OAuth 2.1 setup for Claude/ChatGPT | | [Gitea Guide](docs/GITEA_GUIDE.md) | Gitea plugin configuration | | [Deployment Guide](DEPLOYMENT_GUIDE.md) | Docker and Coolify deployment | | [Troubleshooting](docs/troubleshooting.md) | Common issues and solutions | | [Plugin Development](docs/PLUGIN_DEVELOPMENT.md) | Build your own plugin | --- ## Development ```bash # Install with dev dependencies pip install -e ".[dev]" # Run tests (164 tests) pytest # Format and lint black . && ruff check --fix . # Run server locally python server.py --transport sse --port 8000 ``` --- ## Support This Project MCP Hub is free and open-source. Development is funded by community donations. **Donate via crypto** (NOWPayments): Global, no geographic restrictions. | Goal | Monthly | Enables | |------|---------|---------| | Infrastructure | $50/mo | Demo hosting, CI/CD, domain | | Part-time maintenance | $500/mo | Updates, security patches, issue triage | | Active development | $2,000/mo | New plugins, features, community support | --- ## Contributing We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. **Priority areas:** - New plugin development - Client setup guides - Workflow templates and examples - Test coverage expansion - Translations (i18n) --- ## License MIT License. See [LICENSE](LICENSE). ---