MCP Hub

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 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

596 Tools Across 9 Plugins

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 and add your site credentials
docker compose up -d

Option 2: Docker Hub (No Clone)

# Create a .env file with your credentials (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 with your site credentials
python server.py --transport sse --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. Use your MASTER_API_KEY to log in.

Configure Your Sites

Add site credentials to .env:

# 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

{
  "mcpServers": {
    "mcphub": {
      "url": "https://your-server:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MASTER_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "mcphub": {
      "type": "sse",
      "url": "https://your-server:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MASTER_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "mcphub": {
      "type": "sse",
      "url": "https://your-server:8000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MASTER_API_KEY"
      }
    }
  }
}

Architecture

/mcp                        → Admin endpoint (all 596 tools)
/system/mcp                 → System tools only (24 tools)
/wordpress/mcp              → WordPress tools (67 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)

Compatibility Note: MCP Hub requires FastMCP 2.x (>=2.14.0,<3.0.0). FastMCP 3.0 introduced breaking changes and is not yet supported. If you install dependencies manually, ensure you don't upgrade to FastMCP 3.x.

Documentation

Development

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

# Run tests (289 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 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.