使用说明
MCP Omada
TP-Link Omada SDN控制器용 MCP（模型上下文协议）서버.
使用18个工具管理Omada网络基础架构。
工具列表
| 工具 | 说明 |
|---|---|
omada_get_controller |
查看控制器信息 |
omada_list_sites |
站点列表 |
omada_get_site |
站点详细信息 |
omada_list_devices 设备列表（AP/Switch/Gateway） |
|
omada_get_device |
设备详细信息 |
omada_device_action 设备动作（reboot，adopt） |
|
omada_list_clients |
连接客户端列表 |
omada_get_client |
客户端详细信息 |
omada_client_action |
客户端动作（block，unblock） |
omada_list_wlans |
WLAN/SSID列表 |
omada_list_lans |
LAN网络列表 |
omada_get_wan |
WAN设置 |
omada_list_firewall_rules |
防火墙规则 |
omada_list_port_forwards |
端口转发规则 |
omada_list_routes |
静态路由 |
omada_get_statistics |
流量统计 |
omada_list_events |
事件/通知 |
omada_list_logs |
系统日志 |
前提条件
必须在Omada Controller中创建Open API Client：
- Omada控制器웹 UI>全局视图>设置>平台集成>打开API
- 创建客户端→复制客户端ID、客户端秘密
部署（Dockge）
services:
mcp-omada:
image: ghcr.io/wonjo-linc/mcp-omada:latest
container_name: mcp-omada
restart: unless-stopped
ports:
- "3102:3000"
environment:
- OMADA_URL=https://omada.example.com
- OMADA_CLIENT_ID=your_client_id
- OMADA_CLIENT_SECRET=your_client_secret
- MCP_API_KEY=your_api_key
- OAUTH_CLIENT_ID=your_oauth_client_id
- OAUTH_CLIENT_SECRET=your_oauth_client_secret
- PORT=3000
