pfSense MCP Server

Установка

Работает в

• Claude Desktop
• Claude Code
• SourceCraft
• Koda
• Coddy

Ручная установка

{
  "mcpServers": {
    "pfsense": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gensecaihq/pfsense-mcp-server@v1.1.0", "pfsense-mcp-server"],
      "env": {
        "PFSENSE_URL": "https://192.168.1.1",
        "AUTH_METHOD": "basic",
        "PFSENSE_USERNAME": "admin",
        "PFSENSE_PASSWORD": "your-password",
        "PFSENSE_VERSION": "CE_2_8_1",
        "PFSENSE_CA_FILE": "/path/to/pfsense-ca.pem"
      }
    }
  }
}

Что делает

pfSense MCP Server подключает Claude Desktop, Claude Code и другие MCP-клиенты к файрволу pfSense. Агент смотрит и меняет правила, алиасы, NAT, маршруты, DNS и DHCP, настраивает OpenVPN, IPsec и WireGuard, управляет сертификатами, пользователями и службами, читает журналы и ищет причину недоступности узла. Всего 332 инструмента, 131 из них только читают. Каждое изменение проходит девять проверок: оценка опасности операции, список разрешенных инструментов, очистка параметров, лимит частоты, пробный запуск `dry_run`, подтверждение `confirm=True`, запись ревизии конфигурации, вызов API и журнал аудита с вычеркнутыми секретами. Ответ называет номер ревизии, которую можно восстановить в веб-интерфейсе pfSense. Режим `MCP_READ_ONLY=true` оставляет только читающие инструменты, а `MCP_ALLOWED_TOOLS` разрешает перечисленные записывающие. Нужен пакет REST API для pfSense и Python 3.11 или новее.

Для кого. Сетевым администраторам, которые ведут pfSense и хотят описывать изменения правил и VPN словами, не открывая вкладки веб-интерфейса.

Пример запроса к агенту

Почему 192.168.1.50 не выходит в интернет? Проверь шлюзы и правила LAN, ничего не меняй.

MCP

Транспорт

stdio

Авторизация

ключ необязателен

Ограничения

Нужен пакет pfSense REST API v2 на самом файрволе и Python 3.11 или новее. На PyPI проекта нет, имя `pfsense-mcp-server` там занято другим пакетом: ставить следует из Git командой с `uvx`. Откат ручной: REST API не умеет восстанавливать конфигурацию, сервер лишь возвращает номер ревизии. Флаг `confirm=True` передает клиент, это не отдельное подтверждение человеком, поэтому оставьте включенными запросы подтверждения инструментов. Около 11 инструментов для вложенных объектов, например пулов DHCP и очередей шейпера, не отправляют `parent_id` и падают.

Как отключить. Удалите запись pfsense из claude_desktop_config.json и остановите процесс сервера. Если создали ключ API или отдельного пользователя для агента, отзовите их в pfSense.

Коротко о README

README начинается с примеров разговоров с файрволом и объясняет, зачем нужны защитные слои при управлении боевым pfSense. Дальше идут быстрый старт через uvx или клон, таблица из 332 инструментов по областям, девять проверок перед изменением, поддерживаемые версии, способы входа, развертывание и известные ограничения.