How kevinpez/mikrotik-cursor-mcp works
MikroTik Cursor MCP accepts natural-language router-management requests through Cursor, exposes category-based MCP tools, and executes RouterOS operations over the API with SSH fallback. The graph separates the MCP entry and tool dispatch from domain operations and transport. The README documents broad product capabilities; sampled source confirms representative tool-to-scope and command-to-transport relationships. Several feature branches are documented but their individual implementations were not sampled, so their internal links are left unspecified.
Main entry points: tool_registry.py Tool registry · connector.py Command connector · connection_manager.py SSH pooling · firewall_filter.py Firewall rules
Components 23
MCP interface
- MCP server
src/mcp_mikrotik/server.py - MCP serving
src/mcp_mikrotik/serve.py - Tool registry
src/mcp_mikrotik/tools/tool_registry.py
Tool categories
- Firewall tools
src/mcp_mikrotik/tools/firewall_tools.py - Advanced firewall
src/mcp_mikrotik/tools/firewall_advanced_tools.py - IPv6 tools
src/mcp_mikrotik/tools/ipv6_tools.py - Routing tools
src/mcp_mikrotik/tools/routing_advanced_tools.py - Wireless tools
src/mcp_mikrotik/tools/wireless_tools.py - System tools
src/mcp_mikrotik/tools/system_tools.py - Other categories
src/mcp_mikrotik/tools
Router operations
- Firewall rules
src/mcp_mikrotik/scope/firewall_filter.py - IPv6 networking
src/mcp_mikrotik/scope/ipv6.py - BGP, OSPF, filters
src/mcp_mikrotik/scope/bgp.py - Wireless, CAPsMAN
src/mcp_mikrotik/scope/wireless.py - Other RouterOS features
src/mcp_mikrotik/scope - Safety workflows
src/mcp_mikrotik/safety_manager.py
Connectivity
- Command connector
src/mcp_mikrotik/connector.py - API fallback
src/mcp_mikrotik/api_fallback.py - RouterOS API
src/mcp_mikrotik/api_connector.py - SSH pooling
src/mcp_mikrotik/connection_manager.py - Connection settings
src/mcp_mikrotik/settings/configuration.py
Other components
- Cursor + AI
- MikroTik RouterOS
Connections 26
- Cursor + AI → MCP server: MCP requests
- MCP server → MCP serving: starts
src/mcp_mikrotik/server.py - MCP serving → Tool registry: loads tools
src/mcp_mikrotik/serve.py - Tool registry → Firewall tools: registers
- Tool registry → IPv6 tools: registers
- Tool registry → Routing tools: registers
- Tool registry → Wireless tools: registers
- Tool registry → System tools: registers
- Tool registry → Other categories: registers
- Firewall tools → Firewall rules: calls
src/mcp_mikrotik/tools/firewall_tools.py - Advanced firewall → Firewall rules: calls
src/mcp_mikrotik/tools/firewall_advanced_tools.py - IPv6 tools → IPv6 networking: calls
src/mcp_mikrotik/tools/ipv6_tools.py - Routing tools → BGP, OSPF, filters: calls
src/mcp_mikrotik/tools/routing_advanced_tools.py - Wireless tools → Wireless, CAPsMAN: calls
src/mcp_mikrotik/tools/wireless_tools.py - System tools → Other RouterOS features: calls
src/mcp_mikrotik/tools/system_tools.py - Firewall rules → Command connector: executes commands
src/mcp_mikrotik/scope/firewall_filter.py - IPv6 networking → Command connector: executes commands
src/mcp_mikrotik/scope/ipv6.py - BGP, OSPF, filters → Command connector: executes commands
src/mcp_mikrotik/scope/bgp.py - Wireless, CAPsMAN → Command connector: executes commands
src/mcp_mikrotik/scope/wireless.py - Command connector → SSH pooling: gets connection
src/mcp_mikrotik/connector.py - SSH pooling → MikroTik RouterOS: SSH commands
- API fallback → RouterOS API: tries API
src/mcp_mikrotik/api_fallback.py - API fallback → Command connector: falls back
src/mcp_mikrotik/api_fallback.py - RouterOS API → MikroTik RouterOS: API requests
- Connection settings → SSH pooling: configures
src/mcp_mikrotik/connection_manager.py - Safety workflows → SSH pooling: uses connection manager
src/mcp_mikrotik/safety_manager.py