Mikrotik Mcp

Local

mikrotik-mcp.comCloud & Infra309Updated 1d ago

About Mikrotik Mcp

MikroTik MCP is an MCP server that bridges AI assistants and MikroTik RouterOS devices. Assistants can manage VLANs, firewall rules and DNS settings through natural language requests. Since version 0.14.0, it can also manage multiple devices through an inventory.

Key features

01Natural language control of MikroTik routers
02VLAN management
03Firewall rule configuration
04DNS settings management
05Multi-device inventory support

Use cases

01Letting an AI assistant query or change RouterOS configuration
02Managing a fleet of MikroTik devices from one inventory

MCP support

This project is an MCP server that exposes RouterOS device operations to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "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>"
      }
    }
  }
}

Run commanduvx mcp-server-mikrotik

Environment variables to set

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_PASSWORDSecretSSH password for the MikroTik router (single-device mode)

MIKROTIK_PORTSSH port of the MikroTik router (single-device mode; default: 22)

MIKROTIK_KEY_FILENAMESecretPath 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_INVENTORYSecretInline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIK_INVENTORY_FILE and the single-device variables. Holds credentials.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

pypimcp-server-mikrotik0.24.0.0stdio

Tools

196

Saved tool list · updated 3w ago

Parameter	Type	Required
name	any	No
device	any	No
comment	any	No
dont_encrypt	boolean	No
include_password	boolean	No

Details

From the project README

MikroTik MCP

Overview

MikroTik MCP provides a bridge between AI assistants and MikroTik RouterOS devices. It allows AI assistants to interact with MikroTik routers through natural language requests, executing commands like managing VLANs, configuring firewall rules, handling DNS settings, and more.

Demo Videos

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

Inventory

Note

Since MikroTik MCP version 0.14.0, the MikroTik MCP will allow you to manage multiple MikroTik devices within your fleet structure. The following video simply shows how to use the inventory of MikroTik devices to let LLMs talk with your MikroTik devices.

https://github.com/user-attachments/assets/185b2c39-8f55-4f26-a74c-2ac459ad38f5

Documentation

📚 Full Documentation - Complete guides, API reference, and examples

🌐 Prefer to read online? The same documentation is also published at www.mikrotik-mcp.com (docs) — an optional, web-friendly way to explore the project while reviewing the repo.

Quick Links

Installation Guide - Get started with MikroTik MCP
Testing Guide - Run integration tests
Claude Desktop Integration - Configure for Claude Desktop
MCP Inspector - Interactive testing tool
Contributing Guide - Help improve MikroTik MCP
Articles - Learning resources and tutorials
Diagrams - Architecture and design diagrams (draw.io)

Contributors ❤️

MikroTik MCP is built by the people below. Thank you for every commit, issue, review and idea.

Contributions of every kind are welcome: code, bug reports, documentation and reviews all move the project forward. Start with the Contributing Guide.

Community

Got a question, an idea, or something you'd like to talk through? Join us on Discord. Users and contributors are both welcome, whether you're connecting your first router or working on a PR.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.