{"id":44961074,"url":"https://github.com/airano-ir/mcphub","last_synced_at":"2026-05-21T00:09:04.620Z","repository":{"id":338945009,"uuid":"1159808259","full_name":"airano-ir/mcphub","owner":"airano-ir","description":"AI-native management hub for WordPress, WooCommerce, and self-hosted services via Model Context Protocol (MCP). 589 tools across 9 plugins.","archived":false,"fork":false,"pushed_at":"2026-04-02T06:00:24.000Z","size":1870,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-02T09:45:03.472Z","etag":null,"topics":["ai","automation","claude","mcp","mcphub","model-context-protocol","python","self-hosted","woocommerce","wordpress"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/airano-ir.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-17T07:21:46.000Z","updated_at":"2026-04-02T06:00:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/airano-ir/mcphub","commit_stats":null,"previous_names":["airano-ir/mcphub"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/airano-ir/mcphub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airano-ir%2Fmcphub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airano-ir%2Fmcphub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airano-ir%2Fmcphub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airano-ir%2Fmcphub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/airano-ir","download_url":"https://codeload.github.com/airano-ir/mcphub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/airano-ir%2Fmcphub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31318142,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T21:35:00.834Z","status":"ssl_error","status_checked_at":"2026-04-02T21:34:59.806Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","claude","mcp","mcphub","model-context-protocol","python","self-hosted","woocommerce","wordpress"],"created_at":"2026-02-18T13:05:44.336Z","updated_at":"2026-05-21T00:09:04.609Z","avatar_url":"https://github.com/airano-ir.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- mcp-name: io.github.airano-ir/mcphub --\u003e\n\n# MCP Hub\n\n\u003cdiv align=\"center\"\u003e\n\n**The AI-native management hub for WordPress, WooCommerce, and self-hosted services.**\n\nConnect your sites, stores, repos, and databases — manage them all through Claude, ChatGPT, Cursor, or any MCP client.\n\n[![GitHub Release](https://img.shields.io/github/v/release/airano-ir/mcphub)](https://github.com/airano-ir/mcphub/releases)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776ab.svg)](https://www.python.org/)\n[![PyPI](https://img.shields.io/pypi/v/mcphub-server.svg)](https://pypi.org/project/mcphub-server/)\n[![Docker](https://img.shields.io/docker/v/airano/mcphub?label=docker)](https://hub.docker.com/r/airano/mcphub)\n[![Plugins: 8](https://img.shields.io/badge/plugins-8-orange.svg)]()\n[![CI](https://github.com/airano-ir/mcphub/actions/workflows/ci.yml/badge.svg)](https://github.com/airano-ir/mcphub/actions/workflows/ci.yml)\n\n\u003c/div\u003e\n\n---\n\n## Why MCP Hub?\n\nWordPress powers 43% of the web. WooCommerce runs 36% of online stores. Yet **no MCP server existed** for managing them through AI — until now.\n\nMCP 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:\n\n\u003e *\"Update the SEO meta description for all WooCommerce products that don't have one\"*\n\u003e\n\u003e *\"Create a new blog post about our Black Friday sale and schedule it for next Monday\"*\n\u003e\n\u003e *\"Check the health of all 12 WordPress sites and report any with slow response times\"*\n\n### What Makes MCP Hub Different\n\n| Feature | ManageWP | MainWP | AI Content Plugins | **MCP Hub** |\n|---------|----------|--------|---------------------|-------------|\n| Multi-site management | Yes | Yes | No | **Yes** |\n| AI agent integration | No | No | No | **Native (MCP)** |\n| Full WordPress API | Dashboard | Dashboard | Content only | **67 tools** |\n| WooCommerce management | No | Limited | No | **28 tools** |\n| Git/CI management | No | No | No | **65 tools (Gitea)** |\n| Automation workflows | No | No | No | **56 tools (n8n)** |\n| Self-hosted | No | Yes | N/A | **Yes** |\n| Open source | No | Core only | Varies | **Fully open** |\n| Price | $0.70-8/site/mo | $29-79/yr | $19-79/mo | **Free** |\n\n---\n\n## 8 Public Plugins, Hundreds of Tools\n\nThe exact tool count grows as new plugins ship and existing ones gain endpoints.\nWhat you actually expose is controlled by your `ENABLED_PLUGINS` setting and per-key\nscope — pick a plugin-specific endpoint to keep the surface area small.\n\n| Plugin | Approx. Tools | What You Can Do |\n|--------|---------------:|-----------------|\n| **WordPress** | ~70 | Posts, pages, media (incl. AI image generation), users, menus, taxonomies, SEO (Rank Math/Yoast) |\n| **WooCommerce** | ~30 | Products, orders, customers, coupons, reports, shipping |\n| **WordPress Specialist** | ~50 | Plugins, themes, users, options, cron, page editing, site config + layout, db inspection, bulk fan-out (companion-backed; no Docker socket) |\n| **Gitea** | ~65 | Repos, issues, pull requests, releases, webhooks, organizations, labels, batch files, tree, search, compare |\n| **n8n** | ~55 | Workflows, executions, credentials, variables, audit |\n| **Supabase** | ~70 | Database, auth, storage, edge functions, realtime |\n| **OpenPanel** | ~40 | Events, export, insights, profiles, projects, system |\n| **Coolify** | ~65 | Applications, deployments, servers, projects, databases, services |\n| **System** | ~25 | Health monitoring, API keys, OAuth management, audit |\n\n\u003e Per-site duplication does **not** inflate the tool count — adding a second\n\u003e WordPress site reuses the same WordPress tools with a different `site` argument.\n\n---\n\n## Quick Start\n\n### Option 1: Docker (Recommended)\n\n```bash\ngit clone https://github.com/airano-ir/mcphub.git\ncd mcphub\ncp env.example .env\n# Edit .env — set MASTER_API_KEY, then add sites via the web dashboard\ndocker compose up -d\n```\n\n### Option 2: Docker Hub (No Clone)\n\n```bash\n# Create a .env file with MASTER_API_KEY (see \"Configure Your Sites\" below)\ndocker run -d --name mcphub -p 8000:8000 --env-file .env airano/mcphub:latest\n```\n\n### Option 3: From Source\n\n```bash\ngit clone https://github.com/airano-ir/mcphub.git\ncd mcphub\npip install -e .\ncp env.example .env\n# Edit .env — set MASTER_API_KEY\npython server.py --transport streamable-http --port 8000\n```\n\n### Verify It Works\n\nAfter starting the server, wait ~30 seconds then:\n\n```bash\n# Check server health\ncurl http://localhost:8000/health\n```\n\nOpen the **web dashboard** in your browser: **http://localhost:8000/dashboard**\n\nYou should see the login page. Log in with your `MASTER_API_KEY` or via **GitHub/Google OAuth** (if configured).\n\n### Try It Now (No Setup Required)\n\n**Don't want to self-host?** Use the hosted instance at **[mcp.example.com](https://mcp.example.com)**:\n\n1. Log in with **GitHub** or **Google**\n2. Add your sites via the dashboard (My Sites → Add Service)\n3. Go to **Connect** page — generate config for your AI client\n4. Copy-paste the config into Claude Desktop, VS Code, or Claude Code\n\nYour personal MCP endpoint: `https://mcp.example.com/u/{your-user-id}/{alias}/mcp`\n\n---\n\n### Configure Your Sites\n\nSites are managed via the **web dashboard** — no environment variables needed.\n\n1. Set `MASTER_API_KEY` in your `.env` file\n2. Start the server and open the dashboard\n3. Add sites with their credentials (URL, username, password/token)\n\n```bash\n# .env — only system configuration needed\nMASTER_API_KEY=your-secure-key-here\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eFull Environment Variable Reference\u003c/b\u003e\u003c/summary\u003e\n\n**System Configuration:**\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `MASTER_API_KEY` | Recommended | Auto-generated | Master API key for admin access |\n| `LOG_LEVEL` | No | `INFO` | Logging level (DEBUG, INFO, WARNING, ERROR) |\n| `ENCRYPTION_KEY` | For Live Platform | — | AES-256-GCM key for credential encryption |\n| `OAUTH_JWT_SECRET_KEY` | For OAuth | — | JWT secret for ChatGPT auto-registration (not needed for Claude/Cursor) |\n| `OAUTH_BASE_URL` | For OAuth | — | Public URL of your server (not needed for Claude/Cursor) |\n\n\u003e **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.\n\n**Plugin Credential Reference** — when adding sites via dashboard, you'll need:\n\n| Plugin | Required Credentials | Notes |\n|--------|---------------------|-------|\n| WordPress | URL, Username, App Password | [How to create App Password](https://wordpress.org/documentation/article/application-passwords/) |\n| WooCommerce | URL, Consumer Key, Consumer Secret | WooCommerce → Settings → Advanced → REST API |\n| WordPress Specialist | URL, Username, App Password | Requires [Airano MCP Bridge v2.18.0+](wordpress-plugin/airano-mcp-bridge.zip) on the WP site; user must have `manage_options` |\n| Gitea | URL, Token | Settings → Applications → Personal Access Token |\n| n8n | URL, API Key | Settings → API → Create API Key |\n| Supabase | URL, Service Role Key | Supabase Dashboard → Settings → API |\n| OpenPanel | URL, Client ID, Client Secret | OpenPanel Dashboard → Project Settings |\n\n\u003c/details\u003e\n\n### Connect Your AI Client\n\nAll MCP clients use **Bearer token** authentication: `Authorization: Bearer YOUR_API_KEY`\n\n\u003e Use a plugin-specific endpoint (e.g., `/wordpress/mcp`) instead of `/mcp` to reduce tool count and save tokens. See [Architecture](#architecture) below.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Desktop\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcphub-wordpress\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"http://your-server:8000/wordpress/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `.mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcphub-wordpress\": {\n      \"type\": \"http\",\n      \"url\": \"http://your-server:8000/wordpress/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor\u003c/b\u003e\u003c/summary\u003e\n\nGo to **Settings \u003e MCP Servers \u003e Add Server**:\n\n- **Name**: MCP Hub WordPress\n- **URL**: `http://your-server:8000/wordpress/mcp`\n- **Headers**: `Authorization: Bearer YOUR_API_KEY`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eVS Code + Copilot\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"mcphub-wordpress\": {\n      \"type\": \"http\",\n      \"url\": \"http://your-server:8000/wordpress/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eChatGPT (Remote MCP)\u003c/b\u003e\u003c/summary\u003e\n\nMCP Hub supports **Open Dynamic Client Registration** (RFC 7591). ChatGPT can auto-register as an OAuth client:\n\n1. Deploy MCP Hub with `OAUTH_BASE_URL` set\n2. In ChatGPT, add MCP server: `https://your-server:8000/mcp`\n3. ChatGPT auto-discovers OAuth metadata and registers\n\n\u003c/details\u003e\n\n\u003e **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.\n\n---\n\n## Architecture\n\n```\n/mcp                        → Admin endpoint (every enabled tool)\n/system/mcp                 → System tools only\n/wordpress/mcp              → WordPress tools\n/woocommerce/mcp            → WooCommerce tools\n/wordpress-specialist/mcp   → WordPress Specialist tools (companion-backed)\n/gitea/mcp                  → Gitea tools\n/n8n/mcp                    → n8n tools\n/supabase/mcp               → Supabase tools\n/openpanel/mcp              → OpenPanel tools\n/coolify/mcp                → Coolify tools\n/project/{alias}/mcp        → Per-project endpoint (auto-injects site)\n/u/{user_id}/{alias}/mcp    → Per-user endpoint (hosted/OAuth users)\n```\n\n**Recommendation**: Use plugin-specific endpoints instead of the all-tools `/mcp`\nadmin endpoint to keep your AI client's tool window small (and your token bill\nlower).\n\n| Endpoint | Use Case |\n|----------|----------|\n| `/u/{user_id}/{alias}/mcp` | Hosted users (OAuth login) — single service |\n| `/project/{alias}/mcp` | Single-site workflow (recommended) |\n| `/{plugin}/mcp` | Multi-site management for one service |\n| `/mcp` | Admin \u0026 discovery only — every enabled tool |\n\n### Security\n\n- **OAuth 2.1 + PKCE** (RFC 8414, 7591, 7636) with auto-registration for Claude/ChatGPT\n- **Per-project API keys** with scoped permissions (read/write/admin)\n- **Rate limiting**: 60/min, 1,000/hr, 10,000/day per client\n- **GDPR-compliant audit logging** with automatic sensitive data filtering\n- **Web dashboard** with real-time health monitoring (8 pages, EN/FA i18n)\n\n\u003e **Compatibility Note**: MCP Hub requires FastMCP 3.x (`\u003e=3.0.0,\u003c4.0.0`). The legacy multi-endpoint server and ProjectManager have been removed in v3.5.0.\n\n### WordPress Plugin Requirements\n\nSome MCP Hub tools require companion WordPress plugins:\n\n| Tools | Requirement |\n|-------|-------------|\n| SEO + capability/audit tools (`wordpress_get_post_seo`, capability probe, audit hook, etc.) | [Airano MCP Bridge](https://wordpress.org/plugins/airano-mcp-bridge/) ([GitHub](wordpress-plugin/airano-mcp-bridge/)) + Rank Math or Yoast SEO |\n| WP-CLI tools (15 tools: `wp_cache_*`, `wp_db_*`, etc.) | Docker socket + `CONTAINER` config |\n| WordPress Specialist (~50 tools: plugins / themes / users / options / cron / page editing / site config + layout / db inspection / bulk fan-out) | [Airano MCP Bridge v2.18.0+](wordpress-plugin/airano-mcp-bridge.zip) (no Docker socket needed) |\n| OpenPanel analytics integration | [OpenPanel Self-Hosted](wordpress-plugin/openpanel-self-hosted/) ([Download ZIP](wordpress-plugin/openpanel-self-hosted.zip)) |\n| WooCommerce tools | WooCommerce plugin installed on your WordPress site |\n\n**Docker socket** is needed for the legacy WP-CLI tools (15 helpers under `wordpress_wp_*`). Everything in `wordpress_specialist` works without it. Add to your docker-compose:\n\n```yaml\nvolumes:\n  - /var/run/docker.sock:/var/run/docker.sock:ro\n```\n\nSet 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.\n\n---\n\n## Documentation\n\n| Guide | Description |\n|-------|-------------|\n| [Getting Started](docs/getting-started.md) | Full setup walkthrough |\n| [Architecture](docs/ARCHITECTURE.md) | System design and module reference |\n| [API Keys Guide](docs/API_KEYS_GUIDE.md) | Per-project API key management |\n| [OAuth Guide](docs/OAUTH_GUIDE.md) | OAuth 2.1 setup for Claude/ChatGPT |\n| [Gitea Guide](docs/GITEA_GUIDE.md) | Gitea plugin configuration |\n| [Deployment Guide](docs/DEPLOYMENT_GUIDE.md) | Docker and Coolify deployment |\n| [Troubleshooting](docs/troubleshooting.md) | Common issues and solutions |\n| [Plugin Development](docs/PLUGIN_DEVELOPMENT.md) | Build your own plugin |\n\n---\n\n## Development\n\n```bash\n# Install with dev dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Format and lint\nblack . \u0026\u0026 ruff check --fix .\n\n# Run server locally\npython server.py --transport streamable-http --port 8000\n```\n\n---\n\n## Support This Project\n\nMCP Hub is free and open-source. Development is funded by community donations.\n\n[**Donate with Crypto (NOWPayments)**](https://nowpayments.io/donation/airano) — Global, no geographic restrictions.\n\n| Goal | Monthly | Enables |\n|------|---------|---------|\n| Infrastructure | $50/mo | Demo hosting, CI/CD, domain |\n| Part-time maintenance | $500/mo | Updates, security patches, issue triage |\n| Active development | $2,000/mo | New plugins, features, community support |\n\n---\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Priority areas:**\n- New plugin development\n- Client setup guides\n- Workflow templates and examples\n- Test coverage expansion\n- Translations (i18n)\n\n---\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fairano-ir%2Fmcphub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fairano-ir%2Fmcphub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fairano-ir%2Fmcphub/lists"}