MCP Mikrotik 0bd5688f

MCP运维云端

提供方 Mattieug

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个轻量级的模型上下文协议(MCP)服务器,允许AI助手(如Claude)通过原生RouterOS API直接与MikroTik路由器交互。

一句话选型结论

按资料字段整理

MCP Mikrotik 0bd5688f 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

RouterOSAPIPython本地部署AI集成网络管理MikroTik工具Python实现

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv .venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Mikrotik 0bd5688f当前 4 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Mattieug上游标注的维护方 Mattieug
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.9 KB
来自项目仓库与上游目录的原文,未做删改

🌐 MCP MikroTik — RouterOS AI Bridge

> A lightweight Model Context Protocol (MCP) server that lets AI assistants like Claude interact directly with your MikroTik router via the native RouterOS API.

Tested on a MikroTik RB5009 running RouterOS 7.20.6 — but compatible with any RouterOS 6.43+ device.


✨ What is this?

This project bridges the gap between AI assistants and network infrastructure. Instead of logging into Winbox or SSH to inspect your router, you can simply ask Claude:

  • "What devices are currently connected on DHCP?"
  • "Show me all the running interfaces."
  • "What's the router's current CPU and memory usage?"
  • "Run /ip/firewall/filter/print and summarize the rules."

The server implements the RouterOS API wire protocol from scratch — no third-party RouterOS library required, just Python's standard socket and struct modules.


🛠️ Available MCP Tools

Tool Description
mikrotik_run_command Execute any RouterOS API command with optional attributes and query filters
mikrotik_get_interfaces List all interfaces with name, type, running state and MTU
mikrotik_get_system_resources Get CPU load, RAM usage, uptime and RouterOS version
mikrotik_get_dhcp_leases List active DHCP leases (IP, MAC, hostname, status)

mikrotik_run_command in detail

This is the power tool. It exposes the full RouterOS API to Claude, enabling read and write operations across the entire router configuration.```python

Parameters:

command (str) – API path, e.g. "/ip/address/print"

args (dict, optional) – Attributes, e.g. {"address": "10.0.0.1/24"}

queries (list, optional) – Filters, e.g. ["type=ether", "running=true"]


**Example prompts you can use with Claude:**```
# Read firewall rules
/ip/firewall/filter/print

# Add a DNS entry
command: /ip/dns/static/add  |  args: {"name": "myserver.home", "address": "192.168.1.100"}

# Reboot the router
/system/reboot

# List only ethernet interfaces
command: /interface/print  |  queries: ["type=ether"]

📋 Prerequisites

  • Python 3.10+
  • A MikroTik router running RouterOS 6.43 or later (tested on 7.x)
  • The RouterOS API service enabled on the router

Enable the API on your router

Via the RouterOS terminal or SSH:```
/ip service enable api


> **Tip:** For enhanced security, restrict the API service to a specific source IP:
>```
> /ip service set api address=192.168.1.0/24
> ```

---

## 🚀 Installation

### 1. Clone the repository```bash
git clone https://github.com/Mattieug/mcp-mikrotik.git
cd mcp-mikrotik

2. Create a virtual environment```bash

python -m venv .venv

Linux / macOS

source .venv/bin/activate

Windows

.venv\Scripts\activate


### 3. Install dependencies```bash
pip install mcp

> The server only depends on mcp (for FastMCP) plus Python's standard library.


⚙️ Configuration for Claude Desktop

Open your Claude Desktop config file:

OS Path
Windows %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json

You can also reach it via Claude Desktop → Settings → Developer → Edit Config.

Windows example```json

{
"mcpServers": {
"mikrotik_manager": {
"command": "C:\mcp-mikrotik\.venv\Scripts\python.exe",
"args": ["C:\mcp-mikrotik\mcp-mikrotik.py"],
"env": {
"ROUTEROS_HOST": "192.168.88.1",
"ROUTEROS_USER": "admin",
"ROUTEROS_PASSWORD": "your_password",
"ROUTEROS_PORT": "8728",
"ROUTEROS_USE_SSL": "false"
}
}
}
}


### macOS / Linux example```json
{
  "mcpServers": {
    "mikrotik_manager": {
      "command": "/path/to/mcp-mikrotik/.venv/bin/python",
      "args": ["/path/to/mcp-mikrotik/mcp-mikrotik.py"],
      "env": {
        "ROUTEROS_HOST": "192.168.88.1",
        "ROUTEROS_USER": "admin",
        "ROUTEROS_PASSWORD": "your_password",
        "ROUTEROS_PORT": "8728",
        "ROUTEROS_USE_SSL": "false"
      }
    }
  }
}

> A ready-to-edit template is provided in mcp-mikrotik.json.


🔧 Environment Variables

Variable Default Description
ROUTEROS_HOST 192.168.88.1 Router IP address or hostname
ROUTEROS_USER admin RouterOS API username
ROUTEROS_PASSWORD (empty) RouterOS API password
ROUTEROS_PORT 8728 API port (8728 plain, 8729 SSL)
ROUTEROS_USE_SSL false Set to true to use an encrypted SSL connection

🔒 Security Best Practices

Never commit credentials. Always pass them via environment variables (as shown above), never hardcode them in source files.

Create a dedicated read-only user on your router rather than using the admin account:```
/user group add name=mcp-readonly policy=read,api,test
/user add name=mcp-claude group=mcp-readonly password=strong_random_password


**Restrict API access by source IP** to limit the attack surface:```
/ip service set api address=127.0.0.1/32

Use SSL if you're connecting over an untrusted network:```
ROUTEROS_PORT=8729
ROUTEROS_USE_SSL=true


---

## 🏗️ Architecture

The server is a single Python file implementing two things:

### 1. `RouterOSAPI` — Native wire protocol client

A pure-Python implementation of the RouterOS API protocol, handling:

- TCP connection with optional SSL wrapping
- **Length-encoded word framing** (1–5 byte variable-length prefix)
- Sentence-based request/response model (`!re`, `!done`, `!trap`, `!fatal`)
- Plain-text authentication (RouterOS ≥ 6.43)

This means there is **no external RouterOS library dependency** — the protocol is implemented directly on top of Python's `socket` module.

### 2. MCP Tools — FastMCP server

Built with `FastMCP`, the tools are thin wrappers around `RouterOSAPI.call()`. Each tool opens a connection, executes its command, and closes the connection — keeping the server stateless.```
Claude (AI Assistant)
       │  MCP protocol (stdio)
       ▼
 FastMCP Server  (mcp-mikrotik.py)
       │  RouterOS API protocol (TCP/8728 or TCP/8729)
       ▼
 MikroTik RouterOS

💡 Example Interactions

Once connected, you can have conversations like:

> You: "Which devices are connected to my router right now?"
>
> Claude: (calls mikrotik_get_dhcp_leases) "I can see 7 active leases: your NAS at 192.168.1.10, your Proxmox server at 192.168.1.20…"

> You: "Is the router under any load?"
>
> Claude: (calls mikrotik_get_system_resources) "CPU is at 3%, 512 MB RAM free, uptime is 14 days. Everything looks healthy."

> You: "List all firewall rules that accept traffic on port 443."
>
> Claude: (calls mikrotik_run_command with /ip/firewall/filter/print) "I found 3 rules matching…"


📁 Repository Structure```

mcp-mikrotik/
├── mcp-mikrotik.py # MCP server — RouterOS protocol + tool definitions
├── mcp-mikrotik.json # Claude Desktop config template
└── README.md # This file
```


🗺️ Roadmap

Ideas for future tools:

  • [ ] mikrotik_get_firewall_rules — List and filter firewall rules
  • [ ] mikrotik_get_routes — Show the routing table
  • [ ] mikrotik_get_wireless_clients — List connected Wi-Fi clients
  • [ ] mikrotik_get_logs — Retrieve recent system logs
  • [ ] mikrotik_get_vlan_interfaces — List VLAN interfaces
  • [ ] mikrotik_ping — Trigger a ping from the router and return results

Contributions are welcome — feel free to open a PR or an issue!


📄 License

This project is licensed under the MIT License — free to use, modify and distribute.
See LICENSE for full details.


🙏 Acknowledgements

  • MikroTik RouterOS API documentation
  • FastMCP — the Python framework for building MCP servers
  • Model Context Protocol — the open standard enabling AI-tool integration

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Mikrotik 0bd5688f 怎么安装?

在客户端按下面的安装命令接入:python -m venv .venv。装完在客户端配置里引用同一个包或端点。

MCP Mikrotik 0bd5688f 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Mikrotik 0bd5688f 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Mikrotik 0bd5688f 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Mikrotik 0bd5688f 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Mikrotik 0bd5688f 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 网络管理、Python、Claude。具体工具清单以官方文档为准。

MCP Mikrotik 0bd5688f 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

MCP Mikrotik 0bd5688f 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。