io.github.wiresage/mikrotik-mcp
MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
mcp-server-mikrotikclaude mcp add mikrotik-mcp -e 'MIKROTIK_HOST=<MIKROTIK_HOST>' -e 'MIKROTIK_USERNAME=<MIKROTIK_USERNAME>' -e 'MIKROTIK_PASSWORD=<your mikrotik_password>' -e 'MIKROTIK_PORT=<MIKROTIK_PORT>' -e 'MIKROTIK_KEY_FILENAME=<MIKROTIK_KEY_FILENAME>' -e 'MIKROTIK_READ_ONLY=<MIKROTIK_READ_ONLY>' -e 'MIKROTIK_SENSITIVE_HIDING=<MIKROTIK_SENSITIVE_HIDING>' -e 'MIKROTIK_INVENTORY_FILE=<MIKROTIK_INVENTORY_FILE>' -e 'MIKROTIK_INVENTORY=<your mikrotik_inventory>' -- uvx mcp-server-mikrotik==0.26.2.0
{
"mcpServers": {
"mikrotik-mcp": {
"command": "uvx",
"args": [
"mcp-server-mikrotik==0.26.2.0"
],
"env": {
"MIKROTIK_HOST": "<MIKROTIK_HOST>",
"MIKROTIK_USERNAME": "<MIKROTIK_USERNAME>",
"MIKROTIK_PASSWORD": "<your 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": "<your mikrotik_inventory>"
}
}
}
}
متغيرات البيئة
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_PASSWORDسري SSH password for the MikroTik router (single-device mode)MIKROTIK_PORTSSH port of the MikroTik router (single-device mode; default: 22)MIKROTIK_KEY_FILENAMEPath 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_INVENTORYسري Inline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIK_INVENTORY_FILE and the single-device variables. Holds credentials.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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.
الأسئلة الشائعة
ما هو io.github.wiresage/mikrotik-mcp؟
MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.
كيف أثبّت io.github.wiresage/mikrotik-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add mikrotik-mcp -e 'MIKROTIK_HOST=<MIKROTIK_HOST>' -e 'MIKROTIK_USERNAME=<MIKROTIK_USERNAME>' -e 'MIKROTIK_PASSWORD=<your mikrotik_password>' -e 'MIKROTIK_PORT=<MIKROTIK_PORT>' -e 'MIKROTIK_KEY_FILENAME=<MIKROTIK_KEY_FILENAME>' -e 'MIKROTIK_READ_ONLY=<MIKROTIK_READ_ONLY>' -e 'MIKROTIK_SENSITIVE_HIDING=<MIKROTIK_SENSITIVE_HIDING>' -e 'MIKROTIK_INVENTORY_FILE=<MIKROTIK_INVENTORY_FILE>' -e 'MIKROTIK_INVENTORY=<your mikrotik_inventory>' -- uvx mcp-server-mikrotik==0.26.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.wiresage/mikrotik-mcp إلى مفتاح API؟
نعم. يتطلب MIKROTIK_PASSWORD, MIKROTIK_INVENTORY، وتضبطها في إعداداته.
هل io.github.wiresage/mikrotik-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.wiresage/mikrotik-mcp؟
ينشره wiresage. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.