# MikroMCP

MikroMCP подключает ИИ-агента к роутерам MikroTik на RouterOS и коммутаторам SwOS. Через типизированные инструменты можно проверять сеть и планировать изменения с предварительным просмотром.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 79
- Автор: AliKarami
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AliKarami/MikroMCP
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/mikromcp

## Что делает

Сервер даёт агенту инструменты для проверки состояния RouterOS, сетевых интерфейсов, маршрутов, DHCP, DNS и правил firewall. Для диагностики доступны ping и traceroute с роутера, просмотр логов и другие сетевые операции. Записи можно сначала проверить в режиме dry-run; для изменений предусмотрены планы, снимки конфигурации и откат.

Доступ ограничивается ролевой моделью RBAC, а действия попадают в журнал аудита. Подключение возможно через stdio, Streamable HTTP или SSE. Для Claude Code команда запускает сервер через `npx -y mikromcp`. Поддержка SwOS экспериментальная: она использует обратную разработку HTTP API и проверку совместимости с прошивкой, поэтому для этой функции важна модель коммутатора и версия ПО.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MIKROMCP_CONFIG_PATH`, `MIKROMCP_STDIO_IDENTITY`, `MIKROMCP_LOG_LEVEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MIKROMCP_CONFIG_PATH=<MIKROMCP_CONFIG_PATH> --env MIKROMCP_STDIO_IDENTITY=<MIKROMCP_STDIO_IDENTITY> --env MIKROMCP_LOG_LEVEL=<MIKROMCP_LOG_LEVEL> --transport stdio mikromcp -- npx -y mikromcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mikromcp --env MIKROMCP_CONFIG_PATH=<MIKROMCP_CONFIG_PATH> --env MIKROMCP_STDIO_IDENTITY=<MIKROMCP_STDIO_IDENTITY> --env MIKROMCP_LOG_LEVEL=<MIKROMCP_LOG_LEVEL> -- npx -y mikromcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mikromcp": {
            "command": "npx",
            "args": [
                "-y",
                "mikromcp"
            ],
            "env": {
                "MIKROMCP_CONFIG_PATH": "<MIKROMCP_CONFIG_PATH>",
                "MIKROMCP_STDIO_IDENTITY": "<MIKROMCP_STDIO_IDENTITY>",
                "MIKROMCP_LOG_LEVEL": "<MIKROMCP_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mikromcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mikromcp"
            ],
            "env": {
                "MIKROMCP_CONFIG_PATH": "<MIKROMCP_CONFIG_PATH>",
                "MIKROMCP_STDIO_IDENTITY": "<MIKROMCP_STDIO_IDENTITY>",
                "MIKROMCP_LOG_LEVEL": "<MIKROMCP_LOG_LEVEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MIKROMCP_CONFIG_PATH=<MIKROMCP_CONFIG_PATH> -e MIKROMCP_STDIO_IDENTITY=<MIKROMCP_STDIO_IDENTITY> -e MIKROMCP_LOG_LEVEL=<MIKROMCP_LOG_LEVEL> mikromcp npx -y mikromcp
```
Вместо <…> подставьте свои значения

## Когда брать
- Проверить состояние роутера и последние предупреждения в логах
- Найти отключённые или слишком широкие правила firewall
- Проверить маршрут перед внесением изменений
- Диагностировать связь с роутера с помощью ping и traceroute
- Подготовить изменение конфигурации и откатить его при необходимости

## Примеры запросов агенту
- Проверь на `core-01` системные ресурсы, маршруты и последние ошибки в логах.
- Найди на `edge-01` отключённые правила firewall и покажи их, ничего не меняя.
- Подготовь план добавления статического маршрута на `core-01`, сначала покажи предварительный результат и дождись моего подтверждения.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md