mcphub/DOCKER_README.md

MCP Hub

The AI-native management hub for WordPress, WooCommerce, and self-hosted services.

Version 3.0.1 — 596 tools across 9 plugins. Connect your sites, stores, repos, and databases — manage them all through Claude, ChatGPT, Cursor, or any MCP client.

Quick Start

1. Create a .env file

# Recommended (auto-generates temp key if omitted — check container logs)
MASTER_API_KEY=your-secure-key-here

# Add at least one WordPress site
WORDPRESS_SITE1_URL=https://your-site.com
WORDPRESS_SITE1_USERNAME=admin
WORDPRESS_SITE1_APP_PASSWORD=xxxx xxxx xxxx xxxx
WORDPRESS_SITE1_ALIAS=mysite

2. Run the container

docker run -d \
  --name mcphub \
  -p 8000:8000 \
  --env-file .env \
  airano/mcphub:latest

3. Verify it works

# Health check (wait ~30 seconds for startup)
curl http://localhost:8000/health

# Open the web dashboard
# http://localhost:8000/dashboard

4. Connect your AI client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mcphub": {
      "type": "streamableHttp",
      "url": "http://localhost:8000/wordpress/mcp",
      "headers": {
        "Authorization": "Bearer your-secure-key-here"
      }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "mcphub": {
      "type": "http",
      "url": "http://localhost:8000/wordpress/mcp",
      "headers": {
        "Authorization": "Bearer your-secure-key-here"
      }
    }
  }
}

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

Authentication

MCP Hub uses Bearer token authentication:

Authorization: Bearer YOUR_API_KEY

X-API-Key header and query parameter auth are not supported.

Endpoints

Use the most specific endpoint for your use case:

Endpoint	Tools	site param?	Best for
/project/{alias}/mcp	22-100	No (pre-scoped)	Single-site workflow
/{plugin}/mcp	23-101	Yes	Multi-site management
/mcp	596	Yes	Admin & discovery only

Available plugin endpoints: /wordpress/mcp, /woocommerce/mcp, /wordpress-advanced/mcp, /gitea/mcp, /n8n/mcp, /supabase/mcp, /openpanel/mcp, /appwrite/mcp, /directus/mcp, /system/mcp

Using Docker Compose

services:
  mcphub:
    image: airano/mcphub:latest
    ports:
      - "8000:8000"
    env_file:
      - .env
    volumes:
      - mcphub-data:/app/data
      - mcphub-logs:/app/logs
      # Optional: mount Docker socket for WP-CLI tools
      # - /var/run/docker.sock:/var/run/docker.sock:ro
    restart: unless-stopped

volumes:
  mcphub-data:
  mcphub-logs:

WP-CLI tools (cache flush, database export, plugin updates via CLI) require Docker socket access. Add WORDPRESS_SITE1_CONTAINER=your-wp-container-name to your .env and uncomment the Docker socket volume above.

docker compose up -d

After Starting

URL	Description
http://localhost:8000/health	Health check & status
http://localhost:8000/dashboard	Web dashboard (manage API keys, view sites, health)
http://localhost:8000/mcp	MCP endpoint (connect AI clients here)

Environment Variables

Variable	Required	Description
MASTER_API_KEY	Recommended	API key for authentication. If omitted, a temporary key is auto-generated and printed to logs
WORDPRESS_SITE1_URL	For WP	WordPress site URL
WORDPRESS_SITE1_USERNAME	For WP	WordPress admin username
WORDPRESS_SITE1_APP_PASSWORD	For WP	WordPress Application Password
WORDPRESS_SITE1_ALIAS	Recommended	Friendly name (e.g., myblog)
OAUTH_JWT_SECRET_KEY	For OAuth	JWT secret for ChatGPT/Claude auto-registration
OAUTH_BASE_URL	For OAuth	Public URL of your server

Add more sites with SITE2, SITE3, etc. See full configuration guide.

Supported Plugins

Plugin	Tools	Env Prefix
WordPress	67	WORDPRESS_
WooCommerce	28	WOOCOMMERCE_
WordPress Advanced	22	WORDPRESS_ADVANCED_
Gitea	56	GITEA_
n8n	56	N8N_
Supabase	70	SUPABASE_
OpenPanel	73	OPENPANEL_
Appwrite	100	APPWRITE_
Directus	100	DIRECTUS_

Links

• GitHub: github.com/airano-ir/mcphub
• PyPI: pypi.org/project/mcphub-server
• Documentation: Getting Started Guide
• License: MIT