mcphub-server 3.0.1

AI-native management hub for WordPress, WooCommerce, and self-hosted services via Model Context Protocol (MCP)

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

---

596 Tools Across 9 Plugins

Plugin	Tools	What You Can Do
WordPress	67	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	24	Health monitoring, API keys, OAuth management, audit
Total	596	Constant count — scales to unlimited sites

---

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 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. Use your MASTER_API_KEY to log in.

Configure Your Sites

Add site credentials to .env:

# Master API Key (recommended — auto-generates temp key if omitted)
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

Full Environment Variable Reference

System Configuration:

Variable	Required	Default	Description
MASTER_API_KEY	Recommended	Auto-generated	Master API key for admin access
LOG_LEVEL	No	INFO	Logging level (DEBUG, INFO, WARNING, ERROR)
OAUTH_JWT_SECRET_KEY	For OAuth	—	JWT secret for ChatGPT auto-registration (not needed for Claude/Cursor)
OAUTH_BASE_URL	For OAuth	—	Public URL of your server (not needed for Claude/Cursor)
OAUTH_JWT_ALGORITHM	No	HS256	JWT algorithm
OAUTH_ACCESS_TOKEN_TTL	No	3600	Access token TTL in seconds
OAUTH_REFRESH_TOKEN_TTL	No	604800	Refresh token TTL in seconds
OAUTH_STORAGE_TYPE	No	json	Token storage type
OAUTH_STORAGE_PATH	No	/app/data	Data directory path

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 Site Configuration — Pattern: {PLUGIN_TYPE}_{SITE_ID}_{KEY}

Plugin	Required Keys	Optional Keys
WORDPRESS	URL, USERNAME, APP_PASSWORD	ALIAS, CONTAINER
WOOCOMMERCE	URL, CONSUMER_KEY, CONSUMER_SECRET	ALIAS
WORDPRESS_ADVANCED	URL, USERNAME, APP_PASSWORD, CONTAINER	ALIAS
GITEA	URL, TOKEN	ALIAS
N8N	URL, API_KEY	ALIAS
SUPABASE	URL, SERVICE_ROLE_KEY	ALIAS
OPENPANEL	URL, CLIENT_ID, CLIENT_SECRET	ALIAS
APPWRITE	URL, API_KEY, PROJECT_ID	ALIAS
DIRECTUS	URL, TOKEN	ALIAS

CONTAINER: Docker container name of your WordPress site. Optional for WordPress (enables WP-CLI tools like cache flush, transient management). Required for WordPress Advanced (all 22 tools use WP-CLI). Find your container: docker ps --filter name=wordpress. Also requires Docker socket mount.

Example — Multiple WordPress sites:

WORDPRESS_BLOG_URL=https://blog.example.com
WORDPRESS_BLOG_USERNAME=admin
WORDPRESS_BLOG_APP_PASSWORD=xxxx xxxx xxxx xxxx
WORDPRESS_BLOG_ALIAS=blog

WORDPRESS_SHOP_URL=https://shop.example.com
WORDPRESS_SHOP_USERNAME=admin
WORDPRESS_SHOP_APP_PASSWORD=yyyy yyyy yyyy yyyy
WORDPRESS_SHOP_ALIAS=shop

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.

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

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

Cursor

Go to Settings > MCP Servers > Add Server:

• Name: MCP Hub WordPress
• URL: http://your-server:8000/wordpress/mcp
• Headers: Authorization: Bearer YOUR_API_KEY

VS Code + Copilot

Add to .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 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 (all 596 tools)
/system/mcp                 → System tools only (24 tools)
/wordpress/mcp              → WordPress tools (67 tools)
/woocommerce/mcp            → WooCommerce tools (28 tools)
/wordpress-advanced/mcp     → WordPress Advanced tools (22 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)

Recommendation: Use plugin-specific endpoints instead of /mcp (596 tools) to minimize token usage.

Endpoint	Use Case	Tools
/project/{alias}/mcp	Single-site workflow (recommended)	22-100
/{plugin}/mcp	Multi-site management	23-101
/mcp	Admin & discovery only	596

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.

WordPress Plugin Requirements

Some MCP Hub tools require companion WordPress plugins:

Tools	Requirement
SEO tools (wordpress_get_post_seo, etc.)	SEO API Bridge (Download ZIP) + Rank Math or Yoast SEO
WP-CLI tools (15 tools: wp_cache_*, wp_db_*, etc.)	Docker socket + CONTAINER env var
WordPress Advanced database/system tools	Docker socket + CONTAINER env var
OpenPanel analytics integration	OpenPanel Self-Hosted (Download ZIP)
WooCommerce tools	WooCommerce plugin (separate WOOCOMMERCE_ config)

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
environment:
  WORDPRESS_SITE1_CONTAINER: your-wp-container-name

Without Docker socket, WP-CLI tools return "not available" but all REST API tools work normally.

---

Documentation

Guide	Description
Getting Started	Full setup walkthrough
Architecture	System design and module reference
API Keys Guide	Per-project API key management
OAuth Guide	OAuth 2.1 setup for Claude/ChatGPT
Gitea Guide	Gitea plugin configuration
Deployment Guide	Docker and Coolify deployment
Troubleshooting	Common issues and solutions
Plugin Development	Build your own plugin

---

Development

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

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

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 for guidelines.

Priority areas:

• New plugin development
• Client setup guides
• Workflow templates and examples
• Test coverage expansion
• Translations (i18n)

---

License

MIT License. See LICENSE.

---