AI导哈

Traefik代理管理工具

用于从Claude Code管理本地Traefik反向代理的MCP服务器，支持检查路由器、服务、中间件，管理Docker容器，健康检查域名以及配置CORS和中间件，无需离开编辑器。

  • by dominic-righthere
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dominic-righthere/traefik-hub-mcp

使用说明

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

许可证

麻省理工学院

相关 MCP