zapret2-mcp

MCP-сервер для управления zapret2 — инструментом обработки сетевых пакетов. Позволяет AI-агентам автоматизировать установку, настройку и диагностику zapret2 через Model Context Protocol.

Поддерживаемые платформы

zapret2 поддерживает Windows нативно через zapret-win-bundle, но архитектура (WinDivert, .cmd-скрипты, другие пути) полностью отличается от Linux. Наш MCP-сервер работает только с Linux/OpenWrt-окружениями. Подробнее: docs/windows-support.md.

Установка

npm install -g zapret2-mcp

Или запуск без установки:

npx zapret2-mcp

Настройка MCP-клиента

Claude Desktop

Добавить в ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "zapret2": {
      "command": "npx",
      "args": ["zapret2-mcp"],
      "env": {
        "ZAPRET2_MODE": "ssh",
        "ZAPRET2_SSH_HOST": "192.168.1.1"
      }
    }
  }
}

Claude Code

Добавить в .mcp.json в корне проекта или в ~/.claude/mcp.json глобально:

{
  "mcpServers": {
    "zapret2": {
      "command": "npx",
      "args": ["zapret2-mcp"],
      "env": {
        "ZAPRET2_MODE": "ssh",
        "ZAPRET2_SSH_HOST": "192.168.1.1"
      }
    }
  }
}

Cursor

Добавить в настройки MCP:

{
  "zapret2": {
    "command": "npx",
    "args": ["zapret2-mcp"],
    "env": {
      "ZAPRET2_MODE": "docker"
    }
  }
}

Режимы транспорта

Сервер выполняет команды на целевой машине через один из трёх транспортов.

ssh — удалённый роутер (продакшн)

Подключение по SSH к OpenWrt-роутеру. Основной режим для реального использования.

{ "ZAPRET2_MODE": "ssh", "ZAPRET2_SSH_HOST": "192.168.1.1" }

local — локальная машина

Выполнение команд через bash -c на той же машине, где запущен MCP-сервер. Для Linux-десктопов и WSL2.

{ "ZAPRET2_MODE": "local" }

docker — контейнер (по умолчанию)

Выполнение через docker exec в контейнере с OpenWrt. Для разработки и тестирования.

{ "ZAPRET2_MODE": "docker" }

Переменные окружения

Tools (13)

Определение системы

Управление сервисом

Конфигурация

Установка и диагностика

Интеграция с десктопом

Prompts (5)

MCP-промпты — пошаговые инструкции для типичных сценариев:

MCP Resources

Tools сохраняют вывод в файлы для персистентной истории. Агент может возвращаться к предыдущим результатам и сравнивать прогоны.

• URI: zapret2://logs/{type}/{timestamp}
• Типы логов: blockcheck, service, config
• Хранение: ~/.zapret2-mcp/logs/

Сценарии использования

Роутер (OpenWrt по SSH)

detectSystem → checkPrerequisites → installZapret → updateConfig(NFQWS2_ENABLE=1)
→ startService → verifyBypass

Linux-десктоп

detectSystem → checkPrerequisites → installZapret → configureDns
→ createSystemdService → updateConfig(NFQWS2_ENABLE=1) → startService → verifyBypass

Поиск сетевой стратегии

stopService → runBlockcheck(domain) → прочитать лог resource
→ updateConfig(NFQWS2_OPT=...) → restartService → verifyBypass(domain)

Диагностика

detectSystem → getStatus → getConfig → checkPrerequisites → verifyBypass(domain)
→ анализ результатов

Разработка

git clone https://github.com/your-org/zapret2-mcp.git
cd zapret2-mcp
npm install
npm run build      # TypeScript → build/
npm run dev        # MCP Inspector
npm test           # Unit-тесты (vitest)
npm run test:integration  # Интеграционные тесты (требуется Docker)

Docker-окружение для разработки

cd docker
docker compose build && docker compose up -d

Контейнер zapret2-openwrt: OpenWrt SNAPSHOT, privileged: true, network_mode: host.

Лицензия

MIT