traefik中心mcp
MCP服务器，用于管理来自Claude Code的本地Traefik反向代理。检查路由器、服务和中间件；管理Docker容器；健康检查领域；并配置CORS和中间件——所有这些都无需离开编辑器。
安装
# Run directly (recommended for Claude Code)
npx traefik-hub-mcp
# Or install globally
npm install -g traefik-hub-mcp先决条件
- Node.js >= 18
- 码头工人 正在运行（Docker桌面或守护进程）
- A. 交通 通过以下方式管理堆栈
docker-compose.yml（参见 交通枢纽 对于现成的设置）
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
TRAEFIK_CONFIG_DIR | 是 | -- | Traefik配置目录的路径（包含 traefik.yml 和 dynamic/) |
TRAEFIK_HUB_DIR | 是 | -- | Traefik Hub仓库根目录的路径（包含 docker-compose.yml) |
TRAEFIK_API_URL | 没有 | http://localhost:8080 | Traefik API基础URL |
TRAEFIK_DOMAIN_ALIASES | 没有用于多域路由的逗号分隔的域后缀（例如。， local.domlee.dev) |
配置
克劳德代码
claude mcp add traefik -e TRAEFIK_HUB_DIR=/path/to/traefik-hub -e TRAEFIK_CONFIG_DIR=/path/to/traefik-hub/traefik -e TRAEFIK_API_URL=http://localhost:8080 -- npx -y traefik-hub-mcp或手动添加到 ~/.claude.json 或项目 .mcp.json:
{
"mcpServers": {
"traefik": {
"command": "npx",
"args": ["-y", "traefik-hub-mcp"],
"env": {
"TRAEFIK_HUB_DIR": "/path/to/traefik-hub",
"TRAEFIK_CONFIG_DIR": "/path/to/traefik-hub/traefik",
"TRAEFIK_API_URL": "http://localhost:8080"
}
}
}
}光标
添加到光标设置>MCP服务器：
{
"mcpServers": {
"traefik": {
"command": "npx",
"args": ["-y", "traefik-hub-mcp"],
"env": {
"TRAEFIK_HUB_DIR": "/path/to/traefik-hub",
"TRAEFIK_CONFIG_DIR": "/path/to/traefik-hub/traefik",
"TRAEFIK_API_URL": "http://localhost:8080"
}
}
}
}VS代码（副本）
添加到您的VS代码 settings.json:
{
"mcp": {
"servers": {
"traefik": {
"type": "stdio",
"command": "npx",
"args": ["-y", "traefik-hub-mcp"],
"env": {
"TRAEFIK_HUB_DIR": "/path/to/traefik-hub",
"TRAEFIK_CONFIG_DIR": "/path/to/traefik-hub/traefik",
"TRAEFIK_API_URL": "http://localhost:8080"
}
}
}
}
}帆板运动
增添 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"traefik": {
"command": "npx",
"args": ["-y", "traefik-hub-mcp"],
"env": {
"TRAEFIK_HUB_DIR": "/path/to/traefik-hub",
"TRAEFIK_CONFIG_DIR": "/path/to/traefik-hub/traefik",
"TRAEFIK_API_URL": "http://localhost:8080"
}
}
}
}克莱恩
添加到临床MCP设置：
{
"mcpServers": {
"traefik": {
"command": "npx",
"args": ["-y", "traefik-hub-mcp"],
"env": {
"TRAEFIK_HUB_DIR": "/path/to/traefik-hub",
"TRAEFIK_CONFIG_DIR": "/path/to/traefik-hub/traefik",
"TRAEFIK_API_URL": "http://localhost:8080"
},
"disabled": false
}
}
}工具
API曲菲克
| 工具 | 说明 |
|---|---|
traefik_status | Traefik版本和组件数量 |
list_routers | 列出HTTP路由器（可选按提供商筛选） |
list_services | 列出HTTP服务（可选按提供商筛选） |
list_middlewares | 列出所有HTTP中间件 |
get_router | 获取特定路由器的详细信息 |
码头工人
| 工具 | 说明 |
|---|---|
list_containers | 在上列出容器 traefik-public 网络 |
container_logs | 从容器中获取日志 |
restart_container | 重新启动容器 |
rebuild_service | 重建并重新创建Docker Compose服务(docker compose up -d --build) |
健康与诊断
| 工具 | 说明 |
|---|---|
check_health | 检查域是否正在响应 |
doctor | 全面的堆栈健康检查（Docker、网络、容器、API、端口、配置） |
check_update | 检查是否有更新的Traefik版本，以及更新是否安全 |
check_setup | 验证MCP环境变量和路径是否设置正确 |
堆栈管理
| 工具 | 说明 |
|---|---|
start_traefik | 启动Traefik堆栈(docker compose up -d) |
stop_traefik | 停止Traefik堆栈(docker compose down) |
create_network | 创建 traefik-public Docker网络 |
init_stack | 从头开始初始化（创建网络+启动容器） |
配置
| 工具 | 说明 |
|---|---|
generate_labels | 为新项目生成docker组合Traefik标签 |
add_middleware | 添加中间件 middlewares.yml （Traefik热装弹） |
list_middleware_types | 使用示例配置显示可用的中间件类型 |
get_cors | 显示当前CORS配置 |
update_cors | 从中添加或删除源 cors-dev 中间件 |
多域路由
| 工具 | 说明 |
|---|---|
add_domain_route | 为服务添加多域路由（LAN/Tailscale访问） |
remove_domain_route | 删除多域路由 |
list_domain_routes | 列出所有多域路由 |
发展
git clone https://github.com/dominic-righthere/traefik-hub-mcp.git
cd traefik-hub-mcp
npm install
npm run build
npm test许可证
麻省理工学院