home / mcp / mcp hub mcp server

MCP Hub MCP Server

An AI-native hub that connects WordPress, WooCommerce, and other self-hosted services for AI-assisted management.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "airano-ir-mcphub": {
      "command": "python",
      "args": [
        "server.py",
        "--transport",
        "sse",
        "--port",
        "8000"
      ],
      "env": {
        "MASTER_API_KEY": "YOUR_MASTER_API_KEY"
      }
    }
  }
}

MCP Hub is an AI-native management hub that lets you connect and control WordPress, WooCommerce, and other self-hosted services through AI assistants. You can manage multiple sites and services from a single hub, enabling you to issue natural language commands to perform complex tasks across your infrastructure.

How to use

You interact with MCP Hub through your preferred AI assistant or client. Connect the hub to your AI tools, authenticate with your master key, and start issuing commands that target your connected WordPress sites, stores, repositories, and databases. Use natural language prompts to perform actions across multiple services in a single workflow, such as updating content, checking site health, or automating routine maintenance.

How to install

Prerequisites: you need Python installed to run from source, or you can deploy using Docker. You also need a master API key to secure access.

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

Configure your sites

Set credentials for your sites in the environment file that MCP Hub reads. You will specify a master API key and per-site access details for WordPress, WooCommerce, Gitea, and other integrations you intend to manage.

# 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

To use MCP Hub with your AI assistant, configure your client with the MCP server URL and an authorization header containing your master API key. Use the provided connection blocks for Claude Desktop, Claude Code, Cursor, VS Code Copilot, and ChatGPTRemote to establish the MCP connection.

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

Security and access

MCP Hub uses OAuth 2.1 with PKCE, per-project API keys with scoped permissions, and rate limiting to protect your environment. The web dashboard provides real-time health monitoring and GDPR-friendly audit logging with automatic sensitive data filtering.

Notes and troubleshooting

If you run into startup issues, verify that the port is available, the master API key is correct, and the environment file contains all required site credentials. Check the health endpoint and the web dashboard for status indicators.

Development and testing

For development, install dev dependencies, run tests, format code, and start the local server in a predictable environment.

Available tools

WordPress

67 tools to manage posts, pages, media, users, menus, taxonomies, and SEO integrations within WordPress sites.

WooCommerce

28 tools to manage products, orders, customers, coupons, reports, and shipping for WooCommerce stores.

WordPress Advanced

22 tools for database operations, bulk actions, WP-CLI access, and system management.

Gitea

56 tools to handle repositories, issues, pull requests, releases, webhooks, and organizations.

n8n

56 tools to build and manage workflows, credentials, variables, and audits.

Supabase

70 tools for database, authentication, storage, edge functions, and realtime features.

OpenPanel

73 tools covering events, funnels, profiles, dashboards, and projects.

Appwrite

100 tools for databases, authentication, storage, functions, teams, and messaging.

Directus

100 tools for collections, items, users, files, data flows, and permissions.

System

24 tools for health monitoring, API keys, OAuth management, and audit.