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.

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 MCP server that lets you manage WordPress, WooCommerce, and 8 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

10 Plugins, Hundreds of Tools

The exact tool count grows as new plugins ship and existing ones gain endpoints. What you actually expose is controlled by your ENABLED_PLUGINS setting and per-key scope — pick a plugin-specific endpoint to keep the surface area small.

Per-site duplication does not inflate the tool count — adding a second WordPress site reuses the same WordPress tools with a different site argument.

Quick Start

Option 1: Docker (Recommended)

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

Option 2: Docker Hub (No Clone)

# 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

Option 3: From Source

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

Verify It Works

After starting the server, wait ~30 seconds then:

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

Open the web dashboard in your browser: http://localhost:8000/dashboard

You should see the login page. Log in with your MASTER_API_KEY or via GitHub/Google OAuth (if configured).

Try It Now (No Setup Required)

Don't want to self-host? Use the hosted instance at mcp.example.com:

1. Log in with GitHub or Google

2. Add your sites via the dashboard (My Sites → Add Service)

3. Go to Connect page — generate config for your AI client

4. Copy-paste the config into Claude Desktop, VS Code, or Claude Code

Your personal MCP endpoint: https://mcp.example.com/u/{your-user-id}/{alias}/mcp

Configure Your Sites

Sites are managed via the web dashboard — no environment variables needed.

1. Set MASTER_API_KEY in your .env file

2. Start the server and open the dashboard

3. Add sites with their credentials (URL, username, password/token)

# .env — only system configuration needed
MASTER_API_KEY=your-secure-key-here

System Configuration:

OAuth is only needed for ChatGPT Remote MCP auto-registration. For Claude Desktop, Claude Code, Cursor, and VS Code — just use MASTER_API_KEY with Bearer token auth.

Plugin Credential Reference — when adding sites via dashboard, you'll need:

Connect Your AI Client

All MCP clients use Bearer token authentication: Authorization: Bearer YOUR_API_KEY

Use a plugin-specific endpoint (e.g., /wordpress/mcp) instead of /mcp to reduce tool count and save tokens. See Architecture below.

Add to claude_desktop_config.json:

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

Add to .mcp.json in your project:

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

Go to Settings > MCP Servers > Add Server:

• Name: MCP Hub WordPress

• URL: http://your-server:8000/wordpress/mcp

• Headers: Authorization: Bearer YOUR_API_KEY

Add to .vscode/mcp.json:

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

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

Transport types: Use "type": "streamableHttp" for Claude Desktop and "type": "http" for VS Code/Claude Code. Using "type": "sse" will cause 400 Bad Request errors.

Architecture

/mcp                        → Admin endpoint (every enabled tool)
/system/mcp                 → System tools only
/wordpress/mcp              → WordPress tools
/woocommerce/mcp            → WooCommerce tools
/wordpress-advanced/mcp     → WordPress Advanced tools
/gitea/mcp                  → Gitea tools
/n8n/mcp                    → n8n tools
/supabase/mcp               → Supabase tools
/openpanel/mcp              → OpenPanel tools
/appwrite/mcp               → Appwrite tools
/directus/mcp               → Directus 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)

Recommendation: Use plugin-specific endpoints instead of the all-tools /mcp admin endpoint to keep your AI client's tool window small (and your token bill lower).

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)

Compatibility Note: MCP Hub requires FastMCP 3.x (>=3.0.0,<4.0.0). The legacy multi-endpoint server and ProjectManager have been removed in v3.5.0.

WordPress Plugin Requirements

Some MCP Hub tools require companion WordPress plugins:

Docker socket is needed for WP-CLI and WordPress Advanced system tools. Add to your docker-compose:

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

Set the container field when adding a WordPress site in the dashboard. Without Docker socket, WP-CLI tools return "not available" but all REST API tools work normally.

Documentation

Development

# 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

Support This Project

MCP Hub is free and open-source. Development is funded by community donations.

Donate with Crypto (NOWPayments) — Global, no geographic restrictions.

Contributing

We welcome contributions! See 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.