Mikrotik MCP Server

MCP运维云端

提供方 evya123

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

MikroTik MCP Server是一个为MikroTik RouterOS设备提供的全面模型上下文协议(MCP)服务器实现,通过组织良好的Python代码库提供设备管理、监控和配置的编程访问。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

路由器管理Python本地部署网络配置日志管理系统监控防火墙管理

安装与配置

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

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

  • 资料标注 28 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mikrotik MCP Server当前 28 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

服务器档案

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

详细介绍

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

MikroTik MCP服务器

MikroTik RouterOS设备的全面模型上下文协议(MCP)服务器实现,通过组织良好、生产就绪的Python代码库提供对设备管理、监控和配置的编程访问。

特性

🔍 日志管理

  • 全面的日志检索:使用高级筛选和格式化选项访问系统日志
  • 客户端过滤:针对主题、消息和日志级别的强大过滤功能
  • 专用日志类型:调试、错误、警告和信息日志的专用方法
  • 缓冲支架:从单独的内存日志缓冲区访问日志
  • 额外信息:使用其他元数据和上下文检索日志

🖥️ 系统管理

  • 资源监控:实时系统资源使用和性能指标
  • 健康评估:具有状态指标的综合系统健康评估
  • 性能指标:CPU负载、内存使用情况、磁盘空间和正常运行时间监控
  • 主动警报:资源阈值的警告和关键状态检测

🌐 IP和网络管理

  • IP 地址管理:查看和过滤跨接口的IP地址配置
  • 路由表:访问和分析IP路由配置和网关设置
  • IP池:管理DHCP地址池和分配范围
  • 网络摘要:网络拓扑和配置的全面概述

🔌 接口管理

  • 界面发现:检索具有详细属性的所有已配置接口
  • 接口类型:支持以太网、无线、网桥和其他接口类型
  • 状态监测:实时接口状态、MTU、MAC地址和操作状态
  • 筛选选项:按名称、类型、状态和注释进行高级筛选

🛡️ 防火墙管理

  • 规则管理:全面的防火墙规则检索和过滤
  • NAT配置:网络地址转换规则管理
  • 芒果规则:数据包修改和QoS规则处理
  • 地址列表:安全策略的IP地址列表管理

🌐 DHCP管理

  • 服务器配置:DHCP服务器设置和配置管理
  • 租赁管理:主动DHCP租约监控和跟踪
  • 网络配置:DHCP网络和子网管理
  • 客户管理:DHCP客户端配置和状态

🛠️ MCP集成

  • 资源发现:所有可用资源和工具的丰富元数据
  • 工具集成:具有参数验证的综合工具模式
  • 提示系统:常见任务和故障排除的智能提示
  • 错误处理:具有详细错误消息的稳健错误处理

建筑

该项目遵循模块化、领域驱动的架构:```
src/mcp_mikrotik/
├── init.py # Main package exports
├── base.py # Base client with common functionality
├── models.py # Shared type definitions
├── client.py # Main client combining all specialized clients
├── logs/ # Log management module
│ ├── init.py
│ ├── models.py # Log-specific type definitions
│ └── client.py # Specialized logs client
├── system/ # System management module
│ ├── init.py
│ ├── models.py # System-specific type definitions
│ └── client.py # Specialized system client
├── ip/ # IP and network management module
│ ├── init.py
│ ├── models.py # IP-specific type definitions
│ └── client.py # Specialized IP client
├── interface/ # Interface management module
│ ├── init.py
│ ├── models.py # Interface-specific type definitions
│ └── client.py # Specialized interface client
├── firewall/ # Firewall management module
│ ├── init.py
│ ├── models.py # Firewall-specific type definitions
│ └── client.py # Specialized firewall client
└── dhcp/ # DHCP management module
├── init.py
├── models.py # DHCP-specific type definitions
└── client.py # Specialized DHCP client


## 安装

### 先决条件

- Python 3.11或更高版本
- 访问MikroTik RouterOS设备
- 设备的网络连接

### 设置

1. **克隆存储库**:```bash
git clone
cd mikrotik-mcp
  1. 创建虚拟环境:```bash
    python -m venv venv
    source venv/bin/activate # On Windows: venv\Scripts\activate

1. **安装依赖项**:```bash
pip install -r requirements.txt
  1. 配置环境:```bash
    cp config/example.env .env

Edit .env with your MikroTik device details


## 配置

创建一个 `.env` 使用您的MikroTik设备配置文件:```env
# MikroTik device connection settings
MIKROTIK_HOST=192.168.88.1
MIKROTIK_USERNAME=admin
MIKROTIK_PASSWORD=your_password_here
MIKROTIK_PORT=443
MIKROTIK_USE_SSL=true

# Optional: Debug mode
DEBUG=true

# Optional: Log level
LOG_LEVEL=INFO

用法

基本用法```python

from src.mcp_mikrotik import MikroTikClient

Initialize client

config = {
"host": "192.168.88.1",
"username": "admin",
"password": "your_password",
"useSSL": True
}

client = MikroTikClient(config)

Test connection

is_connected = await client.test_connection()
print(f"Connected: {is_connected}")

Get system information

system_info = await client.get_system_info()
print(f"System uptime: {system_info.get('uptime')}")

Get recent logs

logs = await client.get_logs({"brief": True, "max_logs": 10})
for log in logs:
print(f"{log['time']}: {log['message']}")


### 日志管理```python
# Get specific log types
debug_logs = await client.get_debug_logs()
error_logs = await client.get_error_logs()
warning_logs = await client.get_warning_logs()

# Filter logs by condition
system_logs = await client.find_logs('topics~"system"')
dhcp_logs = await client.find_logs('topics~"dhcp" and message~"assigned"')

# Get logs with extra information
detailed_logs = await client.get_logs_with_extra_info({"brief": False})

系统监控```python

Get comprehensive system health

health = await client.get_system_health()
print(f"System status: {health['status']}")
print(f"Memory usage: {health['memory_usage_percent']}%")
print(f"Disk usage: {health['disk_usage_percent']}%")

Get detailed resource information

resources = await client.get_system_resources()
for resource in resources:
print(f"CPU: {resource['cpu_count']} cores, {resource['cpu_frequency']} MHz")


### 网络管理```python
# Get IP addresses
addresses = await client.get_ip_addresses()
for addr in addresses:
print(f"{addr['address']} on {addr['interface']}")

# Get routing table
routes = await client.get_ip_routes()
for route in routes:
print(f"{route['dst_address']} -> {route['gateway']}")

# Get network summary
summary = await client.get_network_summary()
print(f"Total IP addresses: {summary['ip_addresses_count']}")
print(f"Total routes: {summary['ip_routes_count']}")

接口管理```python

Get all interfaces

interfaces = await client.get_interfaces()
for interface in interfaces:
print(f"{interface['name']}: {interface['type']} - {interface['status']}")

Get specific interface types

ethernet_interfaces = await client.get_ethernet_interfaces()
wireless_interfaces = await client.get_wireless_interfaces()
bridge_interfaces = await client.get_bridge_interfaces()

Filter interfaces by properties

lan_interfaces = await client.get_interfaces({
"type": "ether",
"running": True,
"comment": "LAN"
})


### 防火墙管理```python
# Get firewall rules
firewall_rules = await client.get_firewall_rules()
for rule in firewall_rules:
print(f"{rule['chain']}: {rule['action']} {rule['src_address']} -> {rule['dst_address']}")

# Get NAT rules
nat_rules = await client.get_nat_rules()
for rule in nat_rules:
print(f"NAT: {rule['chain']} {rule['action']}")

# Get address lists
address_lists = await client.get_address_lists()
for addr_list in address_lists:
print(f"List: {addr_list['name']} - {addr_list['address']}")

DHCP管理```python

Get DHCP servers

dhcp_servers = await client.get_dhcp_servers()
for server in dhcp_servers:
print(f"DHCP Server: {server['name']} on {server['interface']}")

Get active leases

dhcp_leases = await client.get_dhcp_leases()
for lease in dhcp_leases:
print(f"Lease: {lease['address']} -> {lease['mac_address']}")

Get DHCP networks

dhcp_networks = await client.get_dhcp_networks()
for network in dhcp_networks:
print(f"Network: {network['name']} - {network['address']}")


## MCP服务器

### 运行服务器```bash
# Run the MCP server
python -m server.server

# Or use the installed script
mikrotik-mcp

可用资源

MCP服务器提供以下资源:

  • mikrotik://logs/recent -最近的系统日志
  • mikrotik://logs/debug -调试日志
  • mikrotik://logs/error -错误日志
  • mikrotik://logs/warning -警告日志
  • mikrotik://logs/info -信息日志
  • mikrotik://logs/detailed -包含额外信息的详细日志
  • mikrotik://system/info -系统信息
  • mikrotik://system/health -系统健康指标
  • mikrotik://ip/addresses -IP地址配置
  • mikrotik://ip/routes -IP路由表
  • mikrotik://ip/pools -IP地址池
  • mikrotik://ip/network_summary -网络配置摘要
  • mikrotik://interface/all -所有接口配置
  • mikrotik://interface/ethernet -以太网接口配置
  • mikrotik://interface/wireless -无线接口配置
  • mikrotik://interface/bridge -网桥接口配置
  • mikrotik://firewall/rules -防火墙规则配置
  • mikrotik://firewall/nat -NAT规则配置
  • mikrotik://firewall/address-lists -防火墙地址列表
  • mikrotik://dhcp/servers -DHCP服务器配置
  • mikrotik://dhcp/leases -活动DHCP租约
  • mikrotik://dhcp/networks -DHCP网络配置

可用工具

  • get_logs -通过筛选检索系统日志
  • get_debug_logs -获取调试日志
  • get_error_logs -获取错误日志
  • get_warning_logs -获取警告日志
  • get_info_logs -获取信息日志
  • get_logs_from_buffer -从特定缓冲区获取日志
  • get_logs_with_extra_info -获取包含额外元数据的日志
  • get_system_info -获取系统信息
  • get_system_health -获取系统健康指标
  • get_ip_addresses -获取IP地址配置
  • get_ip_routes -获取IP路由表
  • get_ip_pools -获取IP地址池
  • get_network_summary -获取网络配置摘要
  • get_interfaces -获取所有接口配置
  • get_ethernet_interfaces -获取以太网接口配置
  • get_wireless_interfaces -获取无线接口配置
  • get_bridge_interfaces -获取网桥接口配置
  • get_firewall_rules -获取防火墙规则配置
  • get_nat_rules -获取NAT规则配置
  • get_mangle_rules -获取混乱的规则配置
  • get_address_lists -获取防火墙地址列表
  • get_dhcp_servers -获取DHCP服务器配置
  • get_dhcp_leases -获取活动DHCP租约
  • get_dhcp_networks -获取DHCP网络配置
  • get_dhcp_clients -获取DHCP客户端配置
  • test_connection -测试设备连接性

发展

运行测试```bash

Run all tests

pytest

Run specific test modules

pytest tests/test_logs_client.py
pytest tests/test_system_client.py
pytest tests/test_ip_client.py

Run with coverage

pytest --cov=src/mcp_mikrotik --cov-report=html


### 代码质量```bash
# Format code with Black
black src/ tests/

# Sort imports with isort
isort src/ tests/

# Lint with flake8
flake8 src/ tests/

# Type checking with mypy
mypy src/

项目结构```

mikrotik-mcp/
├── src/mcp_mikrotik/ # Main package source
│ ├── init.py # Package exports
│ ├── base.py # Base client functionality
│ ├── models.py # Shared type definitions
│ ├── client.py # Main client interface
│ ├── logs/ # Log management module
│ ├── system/ # System management module
│ └── ip/ # IP management module
├── server/ # MCP server implementation
├── tests/ # Comprehensive test suite
├── config/ # Configuration examples
├── requirements.txt # Python dependencies
├── pyproject.toml # Project configuration
└── README.md # This file


## api参考

### MicroTik客户端

提供对所有功能访问的主客户端类:```python
class MikroTikClient:
def __init__(self, config: MikroTikConfig)

# Log management
async def get_logs(options: Optional[GetLogsArgs] = None, max_logs: int = 1000)
async def get_debug_logs(options: Optional[Dict[str, Any]] = None, max_logs: int = 1000)
async def get_error_logs(options: Optional[Dict[str, Any]] = None, max_logs: int = 1000)
async def get_warning_logs(options: Optional[Dict[str, Any]] = None, max_logs: int = 1000)
async def get_info_logs(options: Optional[Dict[str, Any]] = None, max_logs: int = 1000)
async def get_logs_from_buffer(buffer_name: str, options: Optional[Dict[str, Any]] = None, max_logs: int = 1000)
async def get_logs_with_extra_info(options: Optional[Dict[str, Any]] = None, max_logs: int = 1000)
async def find_logs(where: str, options: Optional[Dict[str, Any]] = None)

# System management
async def get_system_info()
async def get_system_resources()
async def get_system_health()

# IP management
async def get_ip_addresses(options: Optional[GetIPAddressesArgs] = None)
async def get_ip_routes(options: Optional[GetIPRoutesArgs] = None)
async def get_ip_pools()
async def get_network_summary()

# Interface management
async def get_interfaces(options: Optional[GetInterfacesArgs] = None)
async def get_ethernet_interfaces()
async def get_wireless_interfaces()
async def get_bridge_interfaces()

# Firewall management
async def get_firewall_rules(options: Optional[GetFirewallRulesArgs] = None)
async def get_nat_rules()
async def get_mangle_rules()
async def get_address_lists()

# DHCP management
async def get_dhcp_servers(options: Optional[GetDHCPServersArgs] = None)
async def get_dhcp_leases()
async def get_dhcp_networks()
async def get_dhcp_clients()

# Connection testing
async def test_connection()

专业客户

通过专用客户端访问专用功能:```python

Log management

logs_client = client.logs
system_client = client.system
ip_client = client.ip
interface_client = client.interface
firewall_client = client.firewall
dhcp_client = client.dhcp

Use specialized methods

debug_logs = await logs_client.get_debug_logs()
system_health = await system_client.get_system_health()
network_summary = await ip_client.get_network_summary()
ethernet_interfaces = await interface_client.get_ethernet_interfaces()
firewall_rules = await firewall_client.get_firewall_rules()
dhcp_leases = await dhcp_client.get_dhcp_leases()
```

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 添加新功能的测试
  5. 确保所有测试通过
  6. 提交拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持

有关支持和问题:

  • 在GitHub上创建问题
  • 检查文档
  • 查看测试示例

路线图

  • [x] 接口管理模块
  • [x] 防火墙配置模块
  • [x] DHCP服务器管理
  • []无线管理模块
  • []VPN配置
  • []用户管理
  • []备份和恢复功能
  • []实时监控和警报
  • []配置模板
  • []批量操作支持

常见问题

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

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

Mikrotik MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Mikrotik MCP Server 收费吗?

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

Mikrotik MCP Server 需要 API Key 吗?

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

Mikrotik MCP Server 能提供哪些能力?

资料显示约 28 个工具;能力标签包括 Python、日志管理、云端部署。具体工具清单以官方文档为准。

Mikrotik MCP Server 需要什么运行环境?

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

Mikrotik MCP Server 是本地还是远程?

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

热门专题

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

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