mcpField
M
Mikrotik Mcp

Mikrotik Mcp

本地服务
mikrotik-mcp.com云与基础设施3091 天前更新

关于 Mikrotik Mcp

MikroTik MCP 是连接 AI 助手与 MikroTik RouterOS 设备的 MCP 服务。用户可通过自然语言请求管理 VLAN、防火墙规则和 DNS 设置等。从 0.14.0 版本起支持管理多台设备的清单。

主要功能

  1. 01通过自然语言操作 MikroTik 路由器
  2. 02管理 VLAN
  3. 03配置防火墙规则
  4. 04设置 DNS

适用场景

  1. 01让 AI 助手查询或修改 RouterOS 设备配置
  2. 02统一管理多台 MikroTik 设备的清单

MCP 相关

该项目是一个 MCP 服务,向 MCP 客户端暴露 RouterOS 设备的相关操作。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"mikrotik": {
"command": "uvx",
"args": [
"mcp-server-mikrotik"
],
"env": {
"MIKROTIK_HOST": "<MIKROTIK_HOST>",
"MIKROTIK_USERNAME": "<MIKROTIK_USERNAME>",
"MIKROTIK_PASSWORD": "<MIKROTIK_PASSWORD>",
"MIKROTIK_PORT": "<MIKROTIK_PORT>",
"MIKROTIK_KEY_FILENAME": "<MIKROTIK_KEY_FILENAME>",
"MIKROTIK_READ_ONLY": "<MIKROTIK_READ_ONLY>",
"MIKROTIK_SENSITIVE_HIDING": "<MIKROTIK_SENSITIVE_HIDING>",
"MIKROTIK_INVENTORY_FILE": "<MIKROTIK_INVENTORY_FILE>",
"MIKROTIK_INVENTORY": "<MIKROTIK_INVENTORY>"
}
}
}
}
启动命令uvx mcp-server-mikrotik
需要配置的环境变量
MIKROTIK_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+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypimcp-server-mikrotik0.24.0.0

工具

196

收录的工具列表 · 更新于 3 周前

参数类型必填说明
nameany否
deviceany否
commentany否
dont_encryptboolean否
include_passwordboolean否

详细介绍

MikroTik MCP

MseeP.ai Security Assessment Badge

MCP Toplist Audited by AddonAudit Website Build Status Tests MIT License Discord

概述

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 由以下成员共同打造。感谢大家提交的每个提交、问题反馈、 评审和创意。

jeff-nasseri goto1134 vavan11 shahabbahojb lwsinclair nieomylnieja hassankhurram OronF pdostal inistor paoValle lucasholman lilianmoraru Kn-ut99 vanelin

欢迎各种形式的贡献:代码、错误报告、文档和评审都能推动项目向前发展。 请从贡献指南开始。

社区

有问题、想法,或想找人讨论某件事?欢迎加入我们的 Discord。无论你是首次连接路由器的用户,还是正在处理 PR 的贡献者,我们都欢迎你。

许可证

此 MCP 服务采用 MIT 许可证。也就是说,你可以自由使用、修改和分发本软件,但须遵守 MIT 许可证的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。