Control D MCP

会話によって Control D を安全に管理するためのローカル Model Context Protocol サーバーです。

プロファイルとエンドポイントの確認、最近ブロックされた DNS クエリの診断、プロファイルの一時停止、ブロック/バイパス/リダイレクトルールの作成、ルールの削除ができます。ライブのポリシー変更にはすべて confirm: true が必要で、変更後には読み戻しチェックが行われます。

セットアップ

Node.js 20 以降と、Control D 専用の 書き込み トークンが必要です。可能であれば、Control D でトークンを信頼できる送信元 IP に制限してください。

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 にアクセスしようとしたんだけど、直近5分で何がブロックされた？」

3. クエリのタイムスタンプと、各ブロックのトリガーとなったルール/フィルタを確認します。

4. 「Global で cdn.example.net の一時的なバイパスを30分間作成して。」

5. アシスタントは正確な提案ミューテーションを表示し、確認付き書き込みツールを呼び出す前に承認を求めます。

ルーティングの場合: まずプロキシロケーションを一覧表示し、次に正確なドメインルールまたは正確なロケーション ID を持つ名前付きサービスをリダイレクトします。YouTube などのサービスは多くの変化するドメインを含む可能性があるため、set_service_policy を使用する方が、ホスト名を手動で管理するよりも通常は安全です。

セキュリティ設計

• 汎用の HTTP/API パススルーツールはありません。

• API および分析ホストは Control D に制限されています。

• トークンは実行時に読み込まれ、返されたりログに記録されたりすることはありません。

• アクティビティログのリクエストは 200 行に制限され、キャッシュされることはありません。

• 書き込みには正確なプロファイル解決と confirm: true が必要です。

• ワイルドカードよりも正確なドメインを優先します。何かをブロック解除する前に結果を検査してください。

API の安定性

Control D は API がバージョン管理されていないと警告しています。アクティビティログといくつかの管理操作は、公開 API リファレンスにすべてが含まれているわけではないため、現在のファーストパーティダッシュボード契約を使用しています。docs/api-contracts.md を参照してください。

謝辞

エンドポイントの動作は、Control D の公式ダッシュボードとコミュニティの Control D Manager Home Assistant integration に対して相互検証されました。このプロジェクトは独立した実装です。

ライセンス

MIT