pfSense MCP Server

Управляйте своим межсетевым экраном pfSense с помощью естественного языка. 327 инструментов. 9 уровней безопасности. Одна команда для запуска.

You: "Block all traffic from 203.0.113.5 on WAN"
Claude: Creates block rule → applies changes → confirms with rollback instructions

pfSense MCP Server подключает Claude Desktop, Claude Code и другие AI-клиенты, совместимые с MCP, к вашему межсетевому экрану pfSense. Задавайте вопросы, диагностируйте проблемы и управляйте своим межсетевым экраном — всё через диалог.

Зачем это нужно

Управление межсетевым экраном pfSense означает бесконечные клики по вкладкам веб-интерфейса, запоминание названий полей и надежду на то, что вы случайно не удалите правило, которое заблокирует вам доступ. С этим MCP-сервером вы описываете то, что хотите, на обычном английском языке, а ИИ выполняет вызовы REST API, проверяет входные данные и предупреждает вас перед выполнением любых деструктивных действий.

Что делает его особенным:

• Каждая деструктивная операция требует явного подтверждения и показывает вам, что именно произойдет

• Автоматическое резервное копирование конфигурации перед каждым удалением/перезагрузкой — с командой отката в одну строку

• Ограничение частоты запросов (rate limiting) предотвращает зацикливание ИИ, которое могло бы перегрузить ваш межсетевой экран правилами

• Санитаризация входных данных блокирует внедрение команд, обход путей и XSS в каждом параметре

Related MCP server: Firewalla MCP Server

Быстрый старт

Предварительные требования: Python 3.10+, pfSense с установленным пакетом REST API v2

git clone https://github.com/gensecaihq/pfsense-mcp-server.git
cd pfsense-mcp-server
pip install -r requirements.txt
cp .env.example .env
# Edit .env: set PFSENSE_URL, AUTH_METHOD, and credentials

Подключение к Claude Desktop — добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pfsense": {
      "command": "python3",
      "args": ["-m", "src.main"],
      "cwd": "/path/to/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_0",
        "VERIFY_SSL": "false"
      }
    }
  }
}

Начните общение с вашим межсетевым экраном. Откройте Claude Desktop и спросите:

• "Покажи мне весь заблокированный трафик за последний час"

• "Какие службы запущены?"

• "Создай проброс порта 443 на 192.168.1.50"

• "Запусти полную проверку состояния системы"

Что вы можете делать

327 инструментов для каждой основной подсистемы pfSense:

Безопасность прежде всего

ИИ, управляющий промышленным межсетевым экраном, нуждается в защитных барьерах. Этот сервер имеет 9 уровней:

"Delete firewall rule 5"

  1. CLASSIFY    → HIGH risk (destructive)
  2. ALLOWLIST   → tool is permitted
  3. SANITIZE    → parameters clean (no injection)
  4. RATE LIMIT  → under 10 deletes/minute
  5. DRY RUN?    → user can preview first
  6. CONFIRM     → blocked until confirm=True
  7. BACKUP      → config revision captured
  8. EXECUTE     → API call made
  9. AUDIT LOG   → action recorded with redacted params

Response includes:
  "config_backup": {
    "pre_change_revision_id": 42,
    "rollback_instruction": "restore_config_backup(revision_id=42, confirm=True)"
  }

Каждая деструктивная операция (52 инструмента удаления/перезагрузки/остановки) требует confirm=True. Каждая операция создания и обновления (112 инструментов) ограничена по частоте и санитаризирована. Каждый чувствительный параметр (пароли, ключи, токены) скрывается в логах и выводах.

Вы также можете:

• Передать dry_run=True для предварительного просмотра любой деструктивной операции без её выполнения

• Передать verify_descr="Allow HTTPS" для проверки того, что вы удаляете правильное правило (защита от сдвига ID)

• Установить MCP_READ_ONLY=true, чтобы открыть доступ только к 118 инструментам для чтения (поиск, получение, диагностика)

• Установить MCP_ALLOWED_TOOLS=search_firewall_rules,get_firewall_log для ограничения доступа конкретными инструментами

Поддерживаемые версии pfSense

Требуется пакет pfSense REST API v2 от jaredhendrickson13.

Аутентификация

Поддерживаются три метода (настраиваются в .env):

Варианты развертывания

stdio (по умолчанию) — для Claude Desktop и Claude Code:

python3 -m src.main

HTTP — для удаленного доступа и многоклиентских настроек:

python3 -m src.main -t streamable-http --port 3000

Docker — защищенный контейнер с файловой системой только для чтения:

docker compose up

Безопасность контейнера: пользователь без прав root (mcp:1000), файловая система только для чтения, все возможности (capabilities) сброшены, noexec tmpfs, no-new-privileges.

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

Тестирование

python3 -m pytest tests/ -v          # 308 tests
python3 -m pytest tests/ --cov=src   # with coverage

Соответствие спецификации MCP

Соответствует MCP 2025-11-25 (последняя версия):

• ToolAnnotations для всех 327 инструментов (readOnlyHint, destructiveHint, idempotentHint)

• Предоставлены serverInfo.version и instructions

• Валидация заголовка Origin (обязательное требование)

• Аутентификация по Bearer токену с использованием сравнения, устойчивого к временным атакам

• Привязка по умолчанию к localhost согласно спецификации SHOULD

• Транспорты stdio и Streamable HTTP

Структура проекта

src/
  main.py              Entry point
  server.py            FastMCP instance + API client
  client.py            pfSense REST API v2 HTTP client
  guardrails.py        9-layer defense-in-depth system
  helpers.py           Validation, parsing, safety guards
  models.py            Data models
  middleware.py        HTTP auth + Origin validation
  tools/               34 tool modules (327 tools)
tests/                 308 tests

Вклад в проект

Нам нужно реальное тестирование в различных средах pfSense. См. CONTRIBUTING или:

1. Сделайте форк и создайте ветку для функции

2. Запустите python3 -m pytest tests/ -v

3. Отправьте PR

Идеи: интеграционные тесты с реальным pfSense, поддержка дополнительных пакетов (Snort, Suricata), мост к локальной LLM Ollama, управление несколькими экземплярами.

Лицензия

MIT

Благодарности

• jaredhendrickson13 / pfrest — пакет pfSense REST API v2

• JeremiahChurch — модульная переработка (PR #5)

• shawnpetersen — обнаружение эндпоинтов API v2 (PR #3)

• Netgate — pfSense

• FastMCP — фреймворк MCP