MCP Mikrotik (mcp-mikrotik)

MCP MikroTik服务器

MCP服务器，用于通过Claude Code配置MikroTik RouterOS 7。允许您使用RouterOS API直接从Claude Code管理路由器。

特性

• 获取系统和资源信息
• 管理网络接口
• 配置IP地址和路由
• 配置防火墙规则和NAT
• 管理DHCP服务器和租约
• 配置DNS
• 管理无线接口
• 使用用户和脚本
• 创建备份和导出配置
• 执行任意RouterOS命令

需求

• Node.js 18或更高版本
• 配备RouterOS 7的MikroTik路由器
• 已在MikroTik上启用API（默认端口8728）

安装

npm install
npm run build

MikroTik配置

1. 通过Winbox或SSH连接到MikroTik

1. 确保API已启用：

   /ip service print

应在端口8728上启用API

1. 如果API被禁用，请启用它：

   /ip service enable api

1. 创建API用户（推荐）：

   /user add name=api-user password=your-password group=full

Claude代码设置

快速启动（本地配置）

1. 复制示例配置：

   cp .mcp.json.example .mcp.json

1. 编辑 .mcp.json 并指定您的路由器详细信息：

   {
     "mcpServers": {
       "mikrotik": {
         "command": "node",
         "args": ["./build/index.js"],
         "env": {
           "MIKROTIK_HOST": "192.168.88.1",
           "MIKROTIK_USER": "admin",
           "MIKROTIK_PASSWORD": "your-password",
           "MIKROTIK_PORT": "8728"
         }
       }
     }
   }

全局配置

或者，将MCP服务器添加到Claude Code的全局配置中：

窗户： %USERPROFILE%\.claude-code\mcp_settings.json Linux/macOS： ~/.claude-code/mcp_settings.json

{
  "mcpServers": {
    "mikrotik": {
      "command": "node",
      "args": ["E:\\OpenWRT\\mcp-microtik\\build\\index.js"],
      "env": {
        "MIKROTIK_HOST": "192.168.88.1",
        "MIKROTIK_USER": "admin",
        "MIKROTIK_PASSWORD": "your-password",
        "MIKROTIK_PORT": "8728"
      }
    }
  }
}

详细说明： 看 设置.md 有关详细的设置说明。

参数：

• MIKROTIK_HOST -您的MikroTik路由器的IP地址
• MIKROTIK_USER -API访问的用户名
• MIKROTIK_PASSWORD -密码
• MIKROTIK_PORT -API端口（通常为8728，用于SSL-8729）

用法

设置后，您可以在Claude Code中使用MCP服务器。命令示例：

获取系统信息

Show MikroTik system information

查看界面

Show all network interfaces

添加IP地址

Add IP address 192.168.1.1/24 to interface ether1

配置防火墙

Add firewall rule: allow SSH (port 22) from subnet 192.168.88.0/24

查看DHCP租约

Show all DHCP leases

创建备份

Create configuration backup

可用工具

• mikrotik_system_info -系统信息
• mikrotik_get_interfaces -列出接口
• mikrotik_get_ip_addresses -列出IP地址
• mikrotik_add_ip_address -添加IP地址
• mikrotik_get_firewall_rules -列出防火墙规则
• mikrotik_add_firewall_rule -添加防火墙规则
• mikrotik_get_dhcp_leases -DHCP租约
• mikrotik_execute_command -执行RouterOS命令

安全

• 不要在配置文件中以纯文本形式存储密码
• 使用单独的用户访问API
• 通过IP地址限制API访问：

  /ip service set api address=192.168.88.0/24

• 建议将API-SSL（端口8729）用于加密连接

发展

在开发模式下运行：

npm run dev

构建项目：

npm run build

许可证

麻省理工学院