antonio-mello-ai/mcp-pfsense

antonio-mello-ai/mcp-pfsense

от antonio-mello-ai
MCP сервер для управления брандмауэрами pfSense через AI-ассистентов. 17 инструментов по шести категориям: система, правила, DHCP, DNS, мониторинг и сервисы. Безопасность с двухшаговым подтверждени...

mcp-pfsense

PyPI Python License: MIT

MCP server for managing pfSense firewalls through AI assistants like Claude, ChatGPT, and Copilot.

Requires: pfrest package installed on your pfSense instance (provides the REST API).

Features

20 tools across 7 categories:

Category Tools Description
System get_system_status, get_interfaces Version, CPU, memory, uptime, temperature, network interfaces
Firewall list_firewall_rules, add_firewall_rule, delete_firewall_rule, list_firewall_aliases Rule management with interface filtering, alias listing
DHCP list_dhcp_leases, list_dhcp_static_mappings, add_dhcp_static_mapping, delete_dhcp_static_mapping Active leases, IP reservations
DNS list_dns_host_overrides, add_dns_host_override, delete_dns_host_override Unbound DNS Resolver host overrides
Pending changes get_pending_changes, apply_changes See what is staged per subsystem (firewall, dhcp, dns) and apply it
Monitoring get_gateway_status, get_arp_table, list_services, get_firewall_logs Gateway health, connected devices, service status, recent raw firewall log entries
Services restart_service Restart any pfSense service
Инструменты были проиндексированы:
add_dhcp_static_mapping

Создаёт статическое сопоставление DHCP (резервирование IP) для MAC-адреса. Откладывается до вызова apply_changes('dhcp') или передачи apply=true.

Параметры
  • applyboolean
  • descrstring
  • hostnamestring
  • interfacestringобязательный
  • ipaddrstringобязательный
  • macstringобязательный
add_dns_host_override

Создаёт запись переопределения DNS-хоста в Unbound DNS Resolver. Откладывается до вызова apply_changes('dns') или передачи apply=true.

Параметры
  • applyboolean
  • descrstring
  • domainstringобязательный
  • hoststringобязательный
  • ipstringобязательный
add_firewall_rule

Добавляет правило брандмауэра. Тип — 'pass', 'block' или 'reject'. Правило находится в состоянии ожидания (неактивно) до вызова apply_changes('firewall') или передачи сюда параметра apply=true.

Параметры
  • applyboolean
  • descrstring
  • destinationstring
  • dstportstring | null
  • interfacestringобязательный
  • ipprotocolstring
  • protocolstring | null
  • sourcestring
  • typestringобязательный
apply_changes

Применяет ВСЕ отложенные изменения подсистемы ('firewall', 'dhcp' или 'dns'). Требует confirm=true. Это перезагружает подсистему, активируя каждое ожидающее изменение, в том числе те, которые человек подготовил в pfSense WebGUI и ещё не проверил.

Параметры
  • confirmboolean
  • subsystemstringобязательный
delete_dhcp_static_mapping

Удаляет статическую привязку DHCP. Требует confirm=true. interface — DHCP-сервер привязки — значение parent_id, возвращаемое list_dhcp_static_mappings; mapping_id — его id там. Действие откладывается до вызова apply_changes('dhcp') или передачи apply=true.

Параметры
  • applyboolean
  • confirmboolean
  • interfacestringобязательный
  • mapping_idintegerобязательный
delete_dns_host_override

Удаляет переопределение DNS-хоста по идентификатору. Требуется confirm=true. Откладывается до вызова apply_changes('dns') или передачи apply=true.

Параметры
  • applyboolean
  • confirmboolean
  • override_idintegerобязательный
delete_firewall_rule

Удаляет правило брандмауэра по его ID (id из list_firewall_rules). Требует confirm=true. Откладывается до вызова apply_changes('firewall') или передачи apply=true.

Параметры
  • applyboolean
  • confirmboolean
  • rule_idintegerобязательный
get_arp_table

Получить ARP-таблицу с подключенными устройствами (IP-адрес, MAC-адрес, интерфейс).

Параметры

Без параметров.

get_firewall_logs

Предоставляет доступ только для чтения к последним записям журнала межсетевого экрана. Каждая запись содержит свой ID и необработанный текст журнала из pfrest. limit ограничивает количество записей (по умолчанию 50). Этот инструмент только читает журналы; он никогда не записывает в межсетевой экран.

Параметры
  • limitinteger
get_gateway_status

Получает статус шлюза, включая задержку, потерю пакетов и состояние онлайн.

Параметры

Без параметров.

get_interfaces

Перечисли все сетевые интерфейсы с их статусом и конфигурацией.

Параметры

Без параметров.

get_pending_changes

Проверяет, есть ли у подсистемы ('firewall', 'dhcp' или 'dns') отложенные, неприменённые изменения.

Параметры
  • subsystemstringобязательный
get_system_status

Получить статус системы pfSense, включая версию, CPU, память, время работы и температуру.

Параметры

Без параметров.

list_dhcp_leases

Выведи активные DHCP-аренды с указанием IP, MAC, имени хоста и времени аренды.

Параметры

Без параметров.

list_dhcp_static_mappings

Перечисляет статические привязки DHCP (резервирование IP-адресов), опционально отфильтрованные по интерфейсу. Каждая привязка содержит parent_id (её DHCP-сервер / интерфейс). Передавайте его как interface в delete_dhcp_static_mapping.

Параметры
  • interfacestring | null
list_dns_host_overrides

Перечислить переопределения хостов DNS-резолвера (локальные DNS-записи).

Параметры

Без параметров.

list_firewall_aliases

Вывести список алиасов брандмауэра (IP-группы, группы портов, списки URL).

Параметры

Без параметров.

list_firewall_rules

Вывести правила брандмауэра, опционально отфильтрованные по интерфейсу.

Параметры
  • interfacestring | null
list_services

Выведи список всех служб и их статус запуска.

Параметры

Без параметров.

restart_service

Перезапустить службу по имени. Требуется confirm=true.

Параметры
  • confirmboolean
  • namestringобязательный
0.3.0основная
0.2.0
0.1.1
0.1.0

Выберите клиент, чтобы установить antonio-mello-ai/mcp-pfsense:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"antonio-mello-ai-mcp-pfsense-ertqfnlhpt\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-pfsense\"],\"env\":{\"PFSENSE_HOST\":\"10.10.10.1\",\"PFSENSE_PASSWORD\":\"your-password\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add antonio-mello-ai-mcp-pfsense-ertqfnlhpt --env PFSENSE_HOST=10.10.10.1 --env PFSENSE_PASSWORD=your-password -- uvx mcp-pfsense

Либо через JSON-конфиг:

claude mcp add-json antonio-mello-ai-mcp-pfsense-ertqfnlhpt "{\"command\":\"uvx\",\"args\":[\"mcp-pfsense\"],\"env\":{\"PFSENSE_HOST\":\"10.10.10.1\",\"PFSENSE_PASSWORD\":\"your-password\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add antonio-mello-ai-mcp-pfsense-ertqfnlhpt --env PFSENSE_HOST=10.10.10.1 --env PFSENSE_PASSWORD=your-password -- uvx mcp-pfsense

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.antonio-mello-ai-mcp-pfsense-ertqfnlhpt]
command = "uvx"
args = ["mcp-pfsense"]

[mcp_servers.antonio-mello-ai-mcp-pfsense-ertqfnlhpt.env]
PFSENSE_HOST = "10.10.10.1"
PFSENSE_PASSWORD = "your-password"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите antonio-mello-ai/mcp-pfsense, а в поле команды запуска — строку ниже:
uvx mcp-pfsense

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например antonio-mello-ai-mcp-pfsense-ertqfnlhpt.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: antonio-mello-ai-mcp-pfsense-ertqfnlhpt
    command: uvx
    args:
      - "mcp-pfsense"
    env:
      PFSENSE_HOST: 10.10.10.1
      PFSENSE_PASSWORD: your-password
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "antonio-mello-ai-mcp-pfsense-ertqfnlhpt": {
      "command": "uvx",
      "args": [
        "mcp-pfsense"
      ],
      "env": {
        "PFSENSE_HOST": "10.10.10.1",
        "PFSENSE_PASSWORD": "your-password"
      }
    }
  }
}

Похожие MCP-сервера

kastelldev/kastell

kastelldev/kastell

от kastelldev

Kastell — MCP-сервер для управления серверами: аудит безопасности, автоматическое исправление и мониторинг. Включает встроенного AI-агента для Claude и Cursor. Выполняет 470+ проверок, поддерживает...

TypeScript⭐ 60
BurtTheCoder/mcp-shodan

BurtTheCoder/mcp-shodan

от burtthecoder

MCP-сервер для работы с Shodan API и CVEDB: IP-разведка, DNS-запросы, поиск устройств и уязвимостей. Помогает анализировать сетевую инфраструктуру и отслеживать угрозы. Для специалистов по безопасн...

TypeScript⭐ 178
Jambozx/onlinecybertools-mcp-server

Jambozx/onlinecybertools-mcp-server

от jambozx

MCP сервер, который подключает AI-агенты (Claude, Codex, Cursor) к каталогу Online Cyber Tools — более 279 инструментов в 15 категориях: кодировка, криптография, хэширование, OSINT, сети, SEO и другое. Установка через npx, настройка переменными. Полезен для разработчиков и хакеров, нуждающихся в ...

JavaScript⭐ 1
operantlabs/operant-mcp

operantlabs/operant-mcp

от operantlabs

MCP-сервер с 51 инструментом для пентеста и анализа безопасности: SQL-инъекции, XSS, сетевая криминалистика (PCAP), анализ памяти, рекон. Полезен специалистам по ИБ для автоматизации тестирования у...

TypeScript⭐ 25
vespo92/OPNSenseMCP

vespo92/OPNSenseMCP

от vespo92

MCP-сервер для комплексного управления OPNsense через ИИ-ассистентов. Включает управление правилами файрвола, настройку NAT и VLAN, диагностику сети с выполнением SSH-команд для автоматизации админ...

TypeScript⭐ 91
imprvhub/mcp-domain-availability

imprvhub/mcp-domain-availability

от imprvhub

MCP сервер для проверки доступности доменов. Использует параллельные запросы DNS и WHOIS по более чем 50 TLD, включая популярные, страновые и новые зоны. Полезен для стартапов, веб-мастеров и AI-ассистентов при подборе доменного имени.

Python⭐ 61
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин