aa8afce707
- Tool count corrected: 589→596 (was missing 4 OAuth + 4 system config tools) - System tools: 17→24 (accurate count of @mcp.tool() functions) - Dashboard defaults to English; Farsi only via ?lang=fa query param - Updated across all files: README, CLAUDE.md, CONTRIBUTING, DOCKER_README, getting-started, CHANGELOG, endpoints config - Removed remaining Phase references from server.py startup log - Tests: 289 passing Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
125 lines
3.1 KiB
Markdown
125 lines
3.1 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# Required
|
|
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
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name mcphub \
|
|
-p 8000:8000 \
|
|
--env-file .env \
|
|
airano/mcphub:latest
|
|
```
|
|
|
|
### 3. Verify it works
|
|
|
|
```bash
|
|
# 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
|
|
|
|
In Claude Desktop's `claude_desktop_config.json`:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"mcphub": {
|
|
"url": "http://localhost:8000/mcp",
|
|
"headers": {
|
|
"Authorization": "Bearer your-secure-key-here"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Using Docker Compose
|
|
|
|
```yaml
|
|
services:
|
|
mcphub:
|
|
image: airano/mcphub:latest
|
|
ports:
|
|
- "8000:8000"
|
|
env_file:
|
|
- .env
|
|
volumes:
|
|
- mcphub-data:/app/data
|
|
- mcphub-logs:/app/logs
|
|
restart: unless-stopped
|
|
|
|
volumes:
|
|
mcphub-data:
|
|
mcphub-logs:
|
|
```
|
|
|
|
```bash
|
|
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` | **Yes** | API key for authentication |
|
|
| `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](https://github.com/airano-ir/mcphub/blob/main/docs/getting-started.md).
|
|
|
|
## Supported Plugins
|
|
|
|
| Plugin | Tools | Env Prefix |
|
|
|--------|-------|------------|
|
|
| WordPress | 67 | `WORDPRESS_` |
|
|
| WooCommerce | 28 | `WOOCOMMERCE_` |
|
|
| WordPress Advanced | 22 | `WORDPRESS_` |
|
|
| 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](https://github.com/airano-ir/mcphub)
|
|
- **PyPI**: [pypi.org/project/mcphub-server](https://pypi.org/project/mcphub-server/)
|
|
- **Documentation**: [Getting Started Guide](https://github.com/airano-ir/mcphub/blob/main/docs/getting-started.md)
|
|
- **License**: MIT
|