diegosouzapw Traefik Hub MCP
Local development reverse proxy management.
Quick Start
Generate Docker labels for a new service?
generate_labels name="myapp" domain="myapp.localhost" port=3000
Returns docker-compose label configuration to copy into your project.
Something not working?
doctor
Comprehensive health check with actionable tips.
Tool Categories
Project Setup
| Tool | Use When |
|---|---|
generate_labels |
Creating docker-compose labels for Docker services |
CORS Management
| Tool | Use When |
|---|---|
get_cors |
Checking current allowed origins |
update_cors |
Adding/removing CORS origins |
Health & Debugging
| Tool | Use When |
|---|---|
doctor |
First step for any problem (comprehensive check) |
check_health |
Testing if specific domain responds |
check_setup |
Verifying MCP configuration |
Inspection
| Tool | Use When |
|---|---|
list_routers |
Seeing all configured routes |
list_services |
Seeing all backend services |
list_middlewares |
Seeing available middlewares |
get_router |
Getting details of specific route |
Stack Control
| Tool | Use When |
|---|---|
init_stack |
First time setup (creates network + starts Traefik) |
start_traefik |
Starting stopped Traefik |
stop_traefik |
Stopping Traefik |
create_network |
Creating traefik-public network only |
Common Workflows
New Project Setup
1. generate_labels name="myapp" domain="myapp.localhost" port=3000
2. update_cors add=["http://myapp.localhost"]
Add the generated labels to your project's docker-compose.yml, then update CORS if needed.
Debug Service Not Reachable
1. doctor # Check all components
2. check_health domain="X.localhost" # Test specific domain
3. list_routers # Verify route exists
4. container_logs name="traefik" # Check Traefik logs
Add CORS Origin
1. get_cors # See current origins
2. update_cors add=["http://newapp.localhost"]
Generate Docker Labels
generate_labels name="myapp" domain="myapp.localhost" port=3000
Returns docker-compose label configuration to copy into your project.
Decision Guide
| Situation | Tool |
|---|---|
| First time ever | init_stack |
| New Docker service | generate_labels |
| CORS errors | get_cors → update_cors |
| Service unreachable | doctor |
| Check specific domain | check_health |
Available Middlewares
Reference with @file suffix (e.g., cors-dev@file):
cors-dev- CORS headers for local developmentsecure-headers- Security headersrate-limit- Rate limiting (100 req/s)strip-api-prefix- Strip/apiprefix from path