关于 Mikrotik Mcp
MikroTik MCP 是连接 AI 助手与 MikroTik RouterOS 设备的 MCP 服务。用户可通过自然语言请求管理 VLAN、防火墙规则和 DNS 设置等。从 0.14.0 版本起支持管理多台设备的清单。
主要功能
- 01通过自然语言操作 MikroTik 路由器
- 02管理 VLAN
- 03配置防火墙规则
- 04设置 DNS
适用场景
- 01让 AI 助手查询或修改 RouterOS 设备配置
- 02统一管理多台 MikroTik 设备的清单
MCP 相关
该项目是一个 MCP 服务,向 MCP 客户端暴露 RouterOS 设备的相关操作。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
uvx mcp-server-mikrotikMIKROTIK_HOSTIP address or hostname of the MikroTik router (single-device mode; default: 127.0.0.1). Not needed when an inventory is configured.MIKROTIK_USERNAMESSH username for the MikroTik router (single-device mode; default: admin)MIKROTIK_PASSWORD密钥SSH password for the MikroTik router (single-device mode)MIKROTIK_PORTSSH port of the MikroTik router (single-device mode; default: 22)MIKROTIK_KEY_FILENAME密钥Path to SSH private key file for key-based authentication (single-device mode)MIKROTIK_READ_ONLYWhen true, expose only tools that do not modify RouterOS or its file store. Use a read-only RouterOS account as defence in depth.MIKROTIK_SENSITIVE_HIDINGWhen true, redact recognized credentials and private key material from tool results, MCP notifications, and logs, and omit tools that return opaque sensitive payloads.MIKROTIK_INVENTORY_FILEPath to a YAML file listing multiple MikroTik devices (title, host, port, username, password, key_filename, tags, region). See docs/reference/inventory.MIKROTIK_INVENTORY密钥Inline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIK_INVENTORY_FILE and the single-device variables. Holds credentials.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
196收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | any | 否 | |
| device | any | 否 | |
| comment | any | 否 | |
| dont_encrypt | boolean | 否 | |
| include_password | boolean | 否 |
详细介绍
MikroTik MCP
概述
MikroTik MCP 为 AI 助手与 MikroTik RouterOS 设备搭建了桥梁。它允许 AI 助手通过自然语言请求与 MikroTik 路由器交互,执行管理 VLAN、配置防火墙规则、处理 DNS 设置等命令。
演示视频
Claude Desktop
https://github.com/user-attachments/assets/24fadcdc-c6a8-48ed-90ac-74baf8f94b59
Inspector
https://github.com/user-attachments/assets/e0301ff2-8144-4503-83d0-48589d95027d
设备清单
说明
自 MikroTik MCP
0.14.0版本起,MikroTik MCP 支持在设备集群中管理多台 MikroTik 设备。以下视频仅演示如何使用 MikroTik 设备清单,让大模型与 MikroTik 设备对话。
https://github.com/user-attachments/assets/185b2c39-8f55-4f26-a74c-2ac459ad38f5
文档
📚 完整文档 - 完整指南、API 参考和示例
🌐 更愿意在线阅读? 同一份文档也发布在 www.mikrotik-mcp.com(文档)——这是一个可选的网页版入口,方便你在查看代码仓库时浏览项目。
快速链接
- 安装指南 - 开始使用 MikroTik MCP
- 测试指南 - 运行集成测试
- Claude Desktop 集成 - 配置 Claude Desktop
- MCP Inspector - 交互式测试工具
- 贡献指南 - 帮助改进 MikroTik MCP
- 文章 - 学习资源和教程
- 图表 - 架构和设计图表(draw.io)
贡献者 ❤️
MikroTik MCP 由以下成员共同打造。感谢大家提交的每个提交、问题反馈、 评审和创意。
欢迎各种形式的贡献:代码、错误报告、文档和评审都能推动项目向前发展。 请从贡献指南开始。
社区
有问题、想法,或想找人讨论某件事?欢迎加入我们的 Discord。无论你是首次连接路由器的用户,还是正在处理 PR 的贡献者,我们都欢迎你。
许可证
此 MCP 服务采用 MIT 许可证。也就是说,你可以自由使用、修改和分发本软件,但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
