Files

airano 809dc264af fix(qa): resolve remaining v3.0.1 issues — CI, code bugs, docs

CI: Fix black formatting in core/site_registry.py
Code: list_projects uses SiteManager, WP Advanced health uses REST API
Docs: Fix transport types, endpoint guide, env var reference for all plugins

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-18 18:55:12 +03:30

4.7 KiB

Raw Blame History

MCP Hub

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

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

4.7 KiB Raw Blame History