Token导航 LogoToken导航TokenDH.com
Omada MCP logo
运维云端stdio官方级别未说明来源级核验

Omada MCP

MCP Server

为TP-Link Omada SDN控制器提供的全功能MCP服务器,支持60多种工具,用于读取、写入和管理站点、设备、客户端、网络等。

工具数

59

提示词数

0

GitHub Stars

1

资源数

0
TypeScript云端部署Docker

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

realtydev

提供方

realtydev

最后核验

2026/5/17 20:21

运行时

Docker

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

docker run -d \

详细介绍

Omada MCP服务器

TP-Link Omada SDN控制器的完整CRUD MCP服务器。公开了60多种用于读取、写入和管理站点、设备、客户端、网络、交换机端口、防火墙等的工具,所有这些都是通过模型上下文协议实现的。

快速开始

使用克劳德代码/克劳德桌面(stdio)

添加到MCP客户端配置中:

{
  "mcpServers": {
    "omada": {
      "command": "node",
      "args": ["/path/to/omada-mcp/dist/index.js"],
      "env": {
        "OMADA_BASE_URL": "https://your-omada-controller.local",
        "OMADA_CLIENT_ID": "your-client-id",
        "OMADA_CLIENT_SECRET": "your-client-secret",
        "OMADA_OMADAC_ID": "your-omadac-id",
        "OMADA_SITE_ID": "your-site-id",
        "OMADA_STRICT_SSL": "false"
      }
    }
  }
}

使用Docker

{
  "mcpServers": {
    "omada": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OMADA_BASE_URL=https://your-omada-controller.local",
        "-e", "OMADA_CLIENT_ID=your-client-id",
        "-e", "OMADA_CLIENT_SECRET=your-client-secret",
        "-e", "OMADA_OMADAC_ID=your-omadac-id",
        "-e", "OMADA_SITE_ID=your-site-id",
        "-e", "OMADA_STRICT_SSL=false",
        "jmtvms/tplink-omada-mcp:latest"
      ]
    }
  }
}

Docker HTTP服务器

docker run -d \
  --env-file .env \
  -e MCP_SERVER_USE_HTTP=true \
  -e MCP_HTTP_BIND_ADDR=0.0.0.0 \
  -p 3000:3000 \
  jmtvms/tplink-omada-mcp:latest

可在 http://localhost:3000/mcp (流)或 http://localhost:3000/sse 上海证券交易所

环境变量

Omada控制器

变量必填默认描述
OMADA_BASE_URL-Omada控制器URL
OMADA_CLIENT_ID-OAuth客户端ID
OMADA_CLIENT_SECRET-OAuth客户端密钥
OMADA_OMADAC_ID-控制器ID(omadacId)
OMADA_SITE_ID-默认站点ID
OMADA_STRICT_SSL没有trueSSL验证(false 自签名)
OMADA_TIMEOUT没有30000请求超时(ms)

MCP服务器

变量必填默认描述
MCP_SERVER_LOG_LEVEL没有infodebug, info, warn, error, silent
MCP_SERVER_LOG_FORMAT没有plainplain, json, gcp-json
MCP_SERVER_USE_HTTP没有false启用HTTP传输
MCP_SERVER_STATEFUL没有false有意义的会议
MCP_HTTP_PORT没有3000HTTP端口
MCP_HTTP_TRANSPORT没有streamstreamsse
MCP_HTTP_BIND_ADDR没有127.0.0.1绑定地址

工具

阅读工具

工具说明
listSites列出控制器上的所有站点
listDevices列出站点的设备
listClients列出站点的活动客户端
getDevice获取特定设备的详细信息
getClient获取特定客户的详细信息
getSwitchStackDetail获取交换机堆栈配置和状态
searchDevices在全球范围内搜索所有站点的设备
listDevicesStats具有分页和过滤功能的设备统计
listMostActiveClients按流量排序的顶级客户
listClientsActivity客户活动时间序列数据
listClientsPastConnections历史客户端连接
getThreatList具有过滤功能的安全威胁列表
getInternetInfo互联网/WAN配置
getPortForwardingStatus端口转发规则(用户/UPnP)
getLanNetworkListLAN网络和VLAN设置
getLanProfileList交换机端口的LAN配置文件
getWlanGroupListWLAN组
getSsidListWLAN组中的SSID
getSsidDetail详细的SSID配置
getFirewallSetting防火墙规则和策略
getSwitchPorts交换机的所有端口(状态、PoE、速度、STP)
getFirmwareDetails设备的固件信息
listEvents分页网站事件
listLogs分页网站日志
listFirewallAcls防火墙ACL规则
listRoutes静态路线
getSwitch完整的交换机信息,包括portList阵列
getCableTestResults开关电缆测试结果
getSwitchNetworks交换机VLAN中继配置

写入工具

工具说明
createLanNetwork创建局域网
updateLanNetwork更新局域网
deleteLanNetwork删除局域网
createLanProfile创建局域网配置文件
updateLanProfile更新局域网配置文件
updateFirewallSetting更新防火墙设置
createFirewallAcl创建防火墙ACL规则
deleteFirewallAcl删除防火墙ACL规则
updateSwitchPort更新交换机端口配置(配置文件、PoE、速度、STP)
updateClient更新客户端设置
setSwitchNetworks设置交换机VLAN中继配置

交换机端口工具

工具说明
setSwitchPortProfile将LAN配置文件分配给单个端口
setSwitchPortPoe在单个端口上启用/禁用PoE
setSwitchPortName在单个端口上设置名称
setSwitchPortStatus启用/禁用单个端口
setSwitchPortProfileOverride在单个端口上启用/禁用配置文件覆盖
batchSetSwitchPortProfile多个端口上的批处理配置文件覆盖
batchSetSwitchPortPoe在多个端口上批量PoE
batchSetSwitchPortStatus批量启用/禁用多个端口
batchSetSwitchPortName在多个端口上批量设置名称
startCableTest在开关上开始电缆测试

行动工具

工具说明
rebootDevice重新启动设备
adoptDevice采用一种设备
blockClient阻止客户端
unblockClient解锁客户端
reconnectClient重新连接客户端
setDeviceLed设置设备LED设置
startFirmwareUpgrade开始固件升级
setGatewayWanConnect连接/断开网关广域网端口

通用的

工具说明
genericApiCall直接调用任何Omada OpenAPI端点

发展

npm install
npm run dev          # Live reload via tsx
npm run build        # Compile TypeScript
npm run check        # Lint + type check
npm start            # Run compiled server (stdio)

码头工人

npm run docker:build   # Build image
npm run docker:run     # Run with .env file

学分

许可证

麻省理工学院

目录标签

目录标签

TypeScript云端部署DockerSDN控制器管理本地部署网络设备管理批量操作工具TP-LinkOmada集成

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

oauth

运行时(runtime,运行环境)

Docker

工具数量(toolCount,工具数)

59

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiooauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP