Mikrotik Router Control
MCP server for Mikrotik
What is Mikrotik Router Control?
Mikrotik Router Control is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for mikrotik
MCP server for Mikrotik
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Mikrotik
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mikrotikConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mikrotik Router Control
The MikroTik MCP Server allows AI assistants to interact with MikroTik RouterOS devices over SSH, enabling natural-language control of network configuration tasks including VLAN management, firewall rule setup, and DNS administration. It runs as a Python process that bridges MCP clients like Claude Desktop to your router's API, translating conversational instructions into RouterOS commands. Network engineers and system administrators use it to configure and monitor MikroTik devices without memorizing RouterOS CLI syntax, making network automation accessible through natural language.
Prerequisites
- Python 3.8 or later installed
- A MikroTik RouterOS device accessible over SSH from the machine running the MCP server
- SSH credentials for the router (host IP, username, and password)
- RouterOS API or SSH access enabled on the device
- An MCP-compatible client such as Claude Desktop
Install the MikroTik MCP server via the Claude MCP registry
The recommended installation method uses the Claude MCP registry, which installs from PyPI and prompts you for your router credentials interactively.
claude mcp add io.github.jeff-nasseri/mikrotik-mcpOr install manually from PyPI
Alternatively, install into a Python virtual environment and run the server directly.
python -m venv .venv
source .venv/bin/activate
pip install -e git+https://github.com/jeff-nasseri/mikrotik-mcp.git#egg=mcp-mikrotik
mcp-server-mikrotikSet your router connection environment variables
Configure the environment variables that tell the server how to reach your MikroTik device. These can be set in your shell or in the MCP client config env block.
export MIKROTIK_HOST=192.168.88.1
export MIKROTIK_USERNAME=admin
export MIKROTIK_PASSWORD=yourpassword
export MIKROTIK_PORT=22Add the server to your MCP client configuration
Add an entry to your `claude_desktop_config.json` pointing to the Python server script with your router credentials in the env block.
{
"mcpServers": {
"mikrotik": {
"command": "python",
"args": ["-m", "mcp_mikrotik.server"],
"env": {
"MIKROTIK_HOST": "192.168.88.1",
"MIKROTIK_USERNAME": "admin",
"MIKROTIK_PASSWORD": "yourpassword",
"MIKROTIK_PORT": "22"
}
}
}
}Restart Claude Desktop and test the connection
Restart your MCP client. Ask it to list network interfaces or show the current firewall rules to verify the server is communicating with your MikroTik device.
Mikrotik Router Control Examples
Client configuration
Claude Desktop configuration for the MikroTik MCP server with SSH credentials provided via environment variables.
{
"mcpServers": {
"mikrotik": {
"command": "python",
"args": ["-m", "mcp_mikrotik.server"],
"env": {
"MIKROTIK_HOST": "192.168.88.1",
"MIKROTIK_USERNAME": "admin",
"MIKROTIK_PASSWORD": "your-router-password",
"MIKROTIK_PORT": "22"
}
}
}
}Prompts to try
Example natural-language prompts for managing a MikroTik router through the MCP server.
- "Show me all current firewall rules on the router"
- "List the VLANs configured on this device"
- "What are the current DNS server settings?"
- "Add a firewall rule to block traffic from 10.0.0.0/8 on the WAN interface"
- "Show me the current interface status and IP addresses"Troubleshooting Mikrotik Router Control
SSH connection refused or timeout
Verify that SSH is enabled on your MikroTik device (IP > Services > SSH). Confirm `MIKROTIK_HOST` is the correct IP and the device is reachable from the machine running the server with `ssh [email protected]`.
Authentication failed with correct credentials
MikroTik has login restrictions by default. Check IP > Services > SSH to ensure the allowed address list includes the host IP. Also verify the user account has sufficient RouterOS permissions for the operations you're attempting.
Server starts but no tools appear in the MCP client
Check that `MIKROTIK_MCP__TRANSPORT` is set to `stdio` (the default) for Claude Desktop. If using HTTP transport, ensure `MIKROTIK_MCP__ALLOWED_HOSTS` includes your client's hostname to prevent DNS-rebinding rejections.
Frequently Asked Questions about Mikrotik Router Control
What is Mikrotik Router Control?
Mikrotik Router Control is a Model Context Protocol (MCP) server that mcp server for mikrotik It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mikrotik Router Control?
Follow the installation instructions on the Mikrotik Router Control GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mikrotik Router Control?
Mikrotik Router Control works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mikrotik Router Control free to use?
Yes, Mikrotik Router Control is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Mikrotik Router Control Alternatives — Similar Cloud Services Servers
Looking for alternatives to Mikrotik Router Control? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mikrotik Router Control in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mikrotik Router Control?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.