# kevinpez/mikrotik-cursor-mcp architecture

> Architecture diagram of the GitHub repository kevinpez/mikrotik-cursor-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kevinpez/mikrotik-cursor-mcp
- Repository: https://github.com/kevinpez/mikrotik-cursor-mcp

## Overview

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: [`src/mcp_mikrotik/tools/tool_registry.py`](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/tool_registry.py) (Tool registry), [`src/mcp_mikrotik/connector.py`](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/connector.py) (Command connector), [`src/mcp_mikrotik/connection_manager.py`](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/connection_manager.py) (SSH pooling), [`src/mcp_mikrotik/scope/firewall_filter.py`](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/firewall_filter.py) (Firewall rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["MCP interface"]
  node_server["MCP server<br/>[server.py]"]
  node_serve["MCP serving<br/>[serve.py]"]
  node_registry["Tool registry<br/>[tool_registry.py]"]
end

subgraph group_tools["Tool categories"]
  node_firewalltools["Firewall tools<br/>[firewall_tools.py]"]
  node_advancedfwtools["Advanced firewall"]
  node_ipv6tools["IPv6 tools<br/>[ipv6_tools.py]"]
  node_routingtools["Routing tools"]
  node_wirelesstools["Wireless tools<br/>[wireless_tools.py]"]
  node_systemtools["System tools<br/>[system_tools.py]"]
  node_moretools["Other categories"]
end

subgraph group_domain["Router operations"]
  node_firewall["Firewall rules<br/>[firewall_filter.py]"]
  node_ipv6["IPv6 networking<br/>[ipv6.py]"]
  node_routing["BGP, OSPF, filters<br/>[bgp.py]"]
  node_wireless["Wireless, CAPsMAN<br/>[wireless.py]"]
  node_moreops["Other RouterOS features"]
  node_safety["Safety workflows<br/>[safety_manager.py]"]
end

subgraph group_transport["Connectivity"]
  node_connector["Command connector<br/>[connector.py]"]
  node_fallback["API fallback<br/>[api_fallback.py]"]
  node_api["RouterOS API<br/>[api_connector.py]"]
  node_ssh["SSH pooling"]
  node_config["Connection settings<br/>[configuration.py]"]
end

node_cursor(("Cursor + AI"))
node_router["MikroTik RouterOS"]

node_cursor -->|"MCP requests"| node_server
node_server -->|"starts"| node_serve
node_serve -->|"loads tools"| node_registry
node_registry -.->|"registers"| node_firewalltools
node_registry -.->|"registers"| node_ipv6tools
node_registry -.->|"registers"| node_routingtools
node_registry -.->|"registers"| node_wirelesstools
node_registry -.->|"registers"| node_systemtools
node_registry -.->|"registers"| node_moretools
node_firewalltools -->|"calls"| node_firewall
node_advancedfwtools -->|"calls"| node_firewall
node_ipv6tools -->|"calls"| node_ipv6
node_routingtools -->|"calls"| node_routing
node_wirelesstools -->|"calls"| node_wireless
node_systemtools -->|"calls"| node_moreops
node_firewall -.->|"executes commands"| node_connector
node_ipv6 -.->|"executes commands"| node_connector
node_routing -->|"executes commands"| node_connector
node_wireless -->|"executes commands"| node_connector
node_connector -->|"gets connection"| node_ssh
node_ssh -->|"SSH commands"| node_router
node_fallback -->|"tries API"| node_api
node_fallback -->|"falls back"| node_connector
node_api -->|"API requests"| node_router
node_config -->|"configures"| node_ssh
node_safety -->|"uses connection manager"| node_ssh

click node_server "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/server.py"
click node_serve "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/serve.py"
click node_registry "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/tool_registry.py"
click node_firewalltools "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/firewall_tools.py"
click node_advancedfwtools "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/firewall_advanced_tools.py"
click node_ipv6tools "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/ipv6_tools.py"
click node_routingtools "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/routing_advanced_tools.py"
click node_wirelesstools "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/wireless_tools.py"
click node_systemtools "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/system_tools.py"
click node_moretools "https://github.com/kevinpez/mikrotik-cursor-mcp/tree/main/src/mcp_mikrotik/tools"
click node_firewall "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/firewall_filter.py"
click node_ipv6 "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/ipv6.py"
click node_routing "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/bgp.py"
click node_wireless "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/wireless.py"
click node_moreops "https://github.com/kevinpez/mikrotik-cursor-mcp/tree/main/src/mcp_mikrotik/scope"
click node_connector "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/connector.py"
click node_fallback "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/api_fallback.py"
click node_api "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/api_connector.py"
click node_ssh "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/connection_manager.py"
click node_config "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/settings/configuration.py"
click node_safety "https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/safety_manager.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_serve,node_registry toneBlue
class node_firewalltools,node_advancedfwtools,node_ipv6tools,node_routingtools,node_wirelesstools,node_systemtools,node_moretools toneAmber
class node_firewall,node_ipv6,node_routing,node_wireless,node_moreops,node_safety,node_router toneMint
class node_connector,node_fallback,node_api,node_ssh,node_config toneRose
class node_cursor toneIndigo
```

## Components

### MCP interface

- [MCP server](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/server.py): `src/mcp_mikrotik/server.py`
- [MCP serving](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/serve.py): `src/mcp_mikrotik/serve.py`
- [Tool registry](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/tool_registry.py): `src/mcp_mikrotik/tools/tool_registry.py`

### Tool categories

- [Firewall tools](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/firewall_tools.py): `src/mcp_mikrotik/tools/firewall_tools.py`
- [Advanced firewall](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/firewall_advanced_tools.py): `src/mcp_mikrotik/tools/firewall_advanced_tools.py`
- [IPv6 tools](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/ipv6_tools.py): `src/mcp_mikrotik/tools/ipv6_tools.py`
- [Routing tools](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/routing_advanced_tools.py): `src/mcp_mikrotik/tools/routing_advanced_tools.py`
- [Wireless tools](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/wireless_tools.py): `src/mcp_mikrotik/tools/wireless_tools.py`
- [System tools](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/tools/system_tools.py): `src/mcp_mikrotik/tools/system_tools.py`
- [Other categories](https://github.com/kevinpez/mikrotik-cursor-mcp/tree/main/src/mcp_mikrotik/tools): `src/mcp_mikrotik/tools`

### Router operations

- [Firewall rules](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/firewall_filter.py): `src/mcp_mikrotik/scope/firewall_filter.py`
- [IPv6 networking](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/ipv6.py): `src/mcp_mikrotik/scope/ipv6.py`
- [BGP, OSPF, filters](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/bgp.py): `src/mcp_mikrotik/scope/bgp.py`
- [Wireless, CAPsMAN](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/scope/wireless.py): `src/mcp_mikrotik/scope/wireless.py`
- [Other RouterOS features](https://github.com/kevinpez/mikrotik-cursor-mcp/tree/main/src/mcp_mikrotik/scope): `src/mcp_mikrotik/scope`
- [Safety workflows](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/safety_manager.py): `src/mcp_mikrotik/safety_manager.py`

### Connectivity

- [Command connector](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/connector.py): `src/mcp_mikrotik/connector.py`
- [API fallback](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/api_fallback.py): `src/mcp_mikrotik/api_fallback.py`
- [RouterOS API](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/api_connector.py): `src/mcp_mikrotik/api_connector.py`
- [SSH pooling](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/connection_manager.py): `src/mcp_mikrotik/connection_manager.py`
- [Connection settings](https://github.com/kevinpez/mikrotik-cursor-mcp/blob/main/src/mcp_mikrotik/settings/configuration.py): `src/mcp_mikrotik/settings/configuration.py`

### Other components

- **Cursor + AI**
- **MikroTik RouterOS**

## Connections

- Cursor + AI → MCP server: MCP requests
- MCP server → MCP serving: starts (evidence: `src/mcp_mikrotik/server.py`)
- MCP serving → Tool registry: loads tools (evidence: `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 (evidence: `src/mcp_mikrotik/tools/firewall_tools.py`)
- Advanced firewall → Firewall rules: calls (evidence: `src/mcp_mikrotik/tools/firewall_advanced_tools.py`)
- IPv6 tools → IPv6 networking: calls (evidence: `src/mcp_mikrotik/tools/ipv6_tools.py`)
- Routing tools → BGP, OSPF, filters: calls (evidence: `src/mcp_mikrotik/tools/routing_advanced_tools.py`)
- Wireless tools → Wireless, CAPsMAN: calls (evidence: `src/mcp_mikrotik/tools/wireless_tools.py`)
- System tools → Other RouterOS features: calls (evidence: `src/mcp_mikrotik/tools/system_tools.py`)
- Firewall rules → Command connector: executes commands (evidence: `src/mcp_mikrotik/scope/firewall_filter.py`)
- IPv6 networking → Command connector: executes commands (evidence: `src/mcp_mikrotik/scope/ipv6.py`)
- BGP, OSPF, filters → Command connector: executes commands (evidence: `src/mcp_mikrotik/scope/bgp.py`)
- Wireless, CAPsMAN → Command connector: executes commands (evidence: `src/mcp_mikrotik/scope/wireless.py`)
- Command connector → SSH pooling: gets connection (evidence: `src/mcp_mikrotik/connector.py`)
- SSH pooling → MikroTik RouterOS: SSH commands
- API fallback → RouterOS API: tries API (evidence: `src/mcp_mikrotik/api_fallback.py`)
- API fallback → Command connector: falls back (evidence: `src/mcp_mikrotik/api_fallback.py`)
- RouterOS API → MikroTik RouterOS: API requests
- Connection settings → SSH pooling: configures (evidence: `src/mcp_mikrotik/connection_manager.py`)
- Safety workflows → SSH pooling: uses connection manager (evidence: `src/mcp_mikrotik/safety_manager.py`)
