mcp-pfsense — MCP-сервер для Claude Code: что делает и как установить
Управляет межсетевым экраном pfSense через ИИ: правилами фильтрации, DHCP-арендами, DNS и системными сервисами.
claude mcp add mcp-pfsense -- uvx mcp-pfsenseЧто делает mcp-pfsense
MCP-сервер связывает ассистента с сетевым шлюзом pfSense через REST API пакета pfrest. Он открывает доступ к 20 инструментам для диагностики и настройки оборудования. Через чат можно отслеживать статус системы, смотреть задержку на шлюзах, проверять таблицу ARP, изучать сырые логи пакетного фильтра или управлять записями Unbound DNS.
Опасные операции защищены двухэтапным подтверждением: удаление правил, сброс служб и применение правок требуют флага confirm=true. Изменения сначала отправляются в черновик. Новые правила не попадут в пакетный фильтр, пока пользователь не выполнит apply_changes или не подтвердит немедленную активацию при вызове.
Для работы обязателен установленный на маршрутизаторе пакет pfrest ветки v2 и окружение Python 3.11 или новее. Без учётной записи с правами api-v2-* в User Manager вызовы будут возвращать ошибки 403.
Какие задачи решает
- Проверить статус внешних шлюзов и задержку пакетов
- Добавить или удалить правила пакетного фильтра на выбранном интерфейсе
- Создать статическую привязку IP к MAC-адресу в DHCP
- Посмотреть список активных аренд адресов и подключённых устройств
- Перезапустить зависший системный сервис pfSense
Примеры запросов агенту
- Покажи статус системы pfSense и задержку на шлюзах
- Создай правило файрвола для порта 8080 TCP на интерфейсе LAN
- Выведи последние 50 записей из журнала межсетевого экрана
Как установить mcp-pfsense
Командой платформы
claude mcp add mcp-pfsense -- uvx mcp-pfsenseuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pfsense <команда>
Командой платформы
codex mcp add mcp-pfsense -- uvx mcp-pfsenseuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pfsense <команда>
Файл настроек
{
"mcpServers": {
"mcp-pfsense": {
"command": "uvx",
"args": [
"mcp-pfsense"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pfsense <команда>
Файл настроек
{
"servers": {
"mcp-pfsense": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-pfsense"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pfsense <команда>
Командой платформы
gemini mcp add mcp-pfsense uvx mcp-pfsenseuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-pfsense <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-pfsense
Как установить mcp-pfsense в Claude Code?
Выполните команду claude mcp add mcp-pfsense -- uvx mcp-pfsense. Затем передайте адрес шлюза и пароль через переменные окружения PFSENSE_HOST и PFSENSE_PASSWORD.
Что делает mcp-pfsense?
Сервер даёт ИИ-ассистенту 20 инструментов для администрирования pfSense. Он позволяет читать логи, контролировать состояние шлюзов, менять правила фильтрации, настраивать записи DNS и DHCP.
Почему созданные правила не начинают действовать сразу?
Сервер сохраняет настройки как отложенные изменения, повторяя логику веб-интерфейса pfSense. Применить их на сетевом фильтре можно инструментом apply_changes с параметром confirm=true.
