Pdns Server

MCP-сервер для управления DNS записями PowerDNS через API PowerDNS-Admin.

Архитектура

src/pdns_mcp_server/
  config.py    — PdnsConfig: чтение конфигурации из переменных окружения
  client.py    — PdnsClient: async HTTP-клиент для PowerDNS-Admin API
  tools.py     — create_app(): регистрация MCP инструментов
  main.py      — точка входа, запуск streamable-http сервера
tests/
  test_config.py   — тесты конфигурации
  test_client.py   — тесты API-клиента (respx моки)
  test_tools.py    — тесты MCP инструментов
  test_main.py     — тесты точки входа

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

Переменная	Обязательно	По умолчанию	Описание
PDNS_ADMIN_URL	Да	—	URL PowerDNS-Admin (например http://pda.example.com:9191)
PDNS_API_KEY	Да	—	API-ключ для X-API-Key аутентификации
PDNS_SERVER_ID	Нет	localhost	ID сервера PowerDNS
PDNS_PORT	Нет	8000	Порт MCP сервера

Инструменты MCP

Инструмент	Описание
list_zones	Список всех DNS зон
get_zone	Детали зоны с записями
create_record	Создать/заменить RRset в зоне
update_record	Обновить содержимое записи
delete_record	Удалить RRset

Подробные параметры и примеры — в docs/usage.md.

Запуск

export PDNS_ADMIN_URL=http://pda.example.com:9191
export PDNS_API_KEY=your-api-key-here
uv run pdns-mcp-server

Сервер будет доступен на http://0.0.0.0:8000 (streamable-http транспорт).

Docker

export PDNS_ADMIN_URL=http://pda.example.com:9191
export PDNS_API_KEY=your-api-key-here
docker compose up

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

uv run pytest -v

Все тесты используют respx для мокирования HTTP-вызовов — не требуют реального PowerDNS.