mikrotik-mcp

Name: mikrotik-mcp
Author: wiresage

本地服务

github.com/wiresage云与基础设施3091 天前更新

代码仓库

关于 mikrotik-mcp

mikrotik-mcp 是面向 MikroTik RouterOS 设备的 MCP 服务，通过 SSH 连接路由器，让 AI 助手以自然语言管理设备。项目支持多设备清单管理（0.14.0 起），适合需要批量维护网络设备的管理员。

主要功能

01通过 SSH 连接 MikroTik 路由器
02防火墙与 NAT 规则配置
03路由、DHCP 与 DNS 设置管理
04WireGuard 与 VLAN 配置
05多设备清单管理

适用场景

01用自然语言调整路由器防火墙规则
02批量查看与维护多台 MikroTik 设备
03通过 AI 助手排查 DNS 或 DHCP 问题

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "wiresage-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.26.2.0stdio