# MikroMCP

> MikroMCP is an open-source MCP server for cloud and infrastructure. Typed, auditable tools for MikroTik RouterOS routers and SwOS switches. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/alikarami/mikromcp
- **MCP Registry name:** io.github.AliKarami/mikromcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Rather than letting a model improvise shell commands on production network gear, MikroMCP puts 133 schema-validated tools between the agent and the router. It targets MikroTik RouterOS through the REST API, with SSH used only for ping and a guarded run_command, and has experimental support for SwOS and SwOS Lite switches.

Change safety is the core idea: dry-run previews, idempotent writes, snapshots, a write journal, plan_changes and apply_plan for staged work, and rollback_change to undo. Read tools retry, each router has its own circuit breaker, and every call carries a correlation ID in structured and audit logs. Coverage runs from interfaces, VLANs, firewall and NAT rules to BGP peers, OSPF neighbours, WireGuard peers and diagnostics such as traceroute and torch.

It runs over stdio, Streamable HTTP or legacy SSE. HTTP mode adds bearer-token auth with bcrypt hashes, RBAC and router or tool restrictions. A router registry YAML defaults to ~/.mikromcp/routers.yaml.

## Features

- **133 typed tools:** Covers system, interfaces, firewall, routing, DHCP, DNS and more.
- **Dry-run and rollback:** plan_changes, apply_plan and rollback_change wrap writes in a reviewable workflow.
- **RBAC and audit logs:** Per-identity tool and router restrictions, with audit logging.
- **SwOS switch support:** Experimental port, PoE and SFP data plus whole-config YAML export and apply.
- **Diagnostics:** ping, traceroute, torch and log filtering run from the router.
- **Several transports:** stdio, Streamable HTTP and legacy SSE.

## Good for

- Summarise a router's health, routes and recent errors
- Audit firewall rules for broad accepts and missing comments
- Preview a static route change before applying it
- Check WireGuard peer handshakes across branch routers
- Back up and apply a SwOS switch configuration

## Install

### Claude Code (Terminal)

```sh
claude mcp add mikromcp -- npx -y mikromcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mikromcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mikromcp": {
      "command": "npx",
      "args": [
        "-y",
        "mikromcp"
      ]
    }
  }
}
```

## Tools

- `plan_changes`: Builds a change plan for review before applying.
- `apply_plan`: Applies a previously created change plan.
- `rollback_change`: Rolls back a recorded change.
- `run_command`: Guarded SSH command execution on a router.

## FAQ

### Is it open source?

Yes, the README calls it an open-source MCP server.

### Does it work with SwOS switches?

Yes, experimentally, over the reverse-engineered .b HTTP API.

### How do I configure routers?

List them in a YAML registry, by default ~/.mikromcp/routers.yaml, set with MIKROMCP_CONFIG_PATH.

### Which clients can use it?

Claude, Cursor, Codex and other MCP clients over stdio or HTTP.

### Is MikroMCP free?

Yes. MikroMCP is open source, so you can use and self-host it for free.

### How do I add MikroMCP to Claude Code?

Run this command in your terminal: claude mcp add mikromcp -- npx -y mikromcp

### What are the best alternatives to MikroMCP?

The closest alternatives to MikroMCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mikromcp
