Control D MCP

Локальный сервер Model Context Protocol для безопасного управления Control D через диалог.

Он может просматривать профили и конечные точки, диагностировать недавно заблокированные DNS-запросы, временно приостанавливать профиль, создавать правила блокировки/обхода/перенаправления и удалять правила. Каждое изменение политики в реальном времени требует confirm: true и сопровождается проверкой обратного чтения.

Настройка

Требуется Node.js 20 или новее и выделенный write-токен Control D. По возможности ограничьте токен доверенными исходными IP-адресами в Control D.

npm install
npm run test

Поместите токен в ~/.config/controld-mcp.env (никогда не в этот репозиторий) и установите режим файла 0600:

CONTROL_D_API_TOKEN=your-dedicated-write-token

Пример конфигурации Codex:

[mcp_servers.controld]
command = "/absolute/path/to/node"
args = ["/absolute/path/to/controld-mcp/dist/index.js"]

Перезапустите MCP-хост после добавления сервера. Процесс MCP может запуститься без токена, но его инструменты будут возвращать ошибку настройки, пока токен не будет добавлен и хост не будет перезапущен.

Related MCP server: technitium-mcp-secure

Типичный сценарий

1. «Покажи мои профили Control D.»

2. «Я только что попробовал example.com. Что было заблокировано за последние пять минут?»

3. Просмотрите временные метки запросов и правило/фильтр, вызвавшие каждую блокировку.

4. «Создай временный обход для cdn.example.net в Global на 30 минут.»

5. Ассистент показывает точную предлагаемую мутацию и запрашивает одобрение перед вызовом подтверждённого инструмента записи.

Для маршрутизации: сначала выведите список прокси-локаций, затем перенаправьте либо точные правила доменов, либо именованный сервис с точным ID локации. Такой сервис, как YouTube, может включать множество меняющихся доменов, поэтому set_service_policy обычно безопаснее, чем попытка вручную поддерживать его hostname.

Модель безопасности

• Нет универсального инструмента HTTP/API-проксирования.

• API и аналитические хосты ограничены Control D.

• Токены загружаются во время выполнения и никогда не возвращаются и не логируются.

• Запросы журнала активности ограничены 200 строками и никогда не кэшируются.

• Записи требуют точного разрешения профиля и confirm: true.

• Предпочитайте точные домены подстановочным знакам. Проверяйте результаты перед разблокировкой чего-либо.

Стабильность API

Control D предупреждает, что его API не имеет версий. Журнал активности и несколько операций управления используют текущие контракты первой стороны панели управления, поскольку они не все присутствуют в публичной справочной документации API. См. docs/api-contracts.md.

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

Поведение конечных точек было перепроверено с официальной панелью управления Control D и интеграцией сообщества Control D Manager Home Assistant. Этот проект является независимой реализацией.

Лицензия

MIT