defined-mcp

Defined Networking API用のMCPサーバーです。

インストール

uv tool install git+https://github.com/quickvm/defined-mcp.git

特定のバージョンやブランチをインストールする場合:

uv tool install git+https://github.com/quickvm/defined-mcp.git@main

ローカル開発用:

git clone git@github.com:quickvm/defined-mcp.git
cd defined-mcp
uv tool install --editable .

Related MCP server: UniFi MCP Server

設定

DEFINED_API_KEY環境変数にDefined NetworkingのAPIキーを設定してください。 管理パネルから取得できます。

export DEFINED_API_KEY=dnkey-...

使用方法

Claude Codeへの追加

claude mcp add defined_mcp -- defined-mcp serve

その後、Claude Codeを再起動してください。

接続の確認

defined-mcp check

スタンドアロンでの実行

defined-mcp serve

利用可能なツール

ホスト

• list_hosts — フィルター（ロール、ブロック、ライトハウス、リレー）を使用してホストを一覧表示

• get_host — ホストの詳細を取得

• create_host — ホスト/ライトハウス/リレーを作成

• update_host — ホストを更新（完全置換）

• delete_host — ホストを削除

• block_host / unblock_host — ホストをブロック/ブロック解除

• add_host_tag / remove_host_tag — ホストにタグを追加/削除

• create_enrollment_code — 登録コードを生成

• create_host_and_enrollment_code — ホストと登録コードを作成

ロールとファイアウォールルール

• list_roles / get_role — ファイアウォールルールを含むロールを一覧表示/取得

• create_role / update_role — ロールを作成/更新（完全置換）

• delete_role — ロールを削除

• add_firewall_rule — ロールにファイアウォールルールを追加（フラットなパラメータ、JSONなし）

• remove_firewall_rule — インデックスでファイアウォールルールを削除

タグ

• list_tags / get_tag — タグを一覧表示/取得

• create_tag / update_tag — 設定オーバーライドを使用してタグを作成/更新

• delete_tag — タグを削除

• add_tag_config_override — タグに設定オーバーライドを追加/置換

• remove_tag_config_override — キーで設定オーバーライドを削除

ネットワーク

• list_networks / get_network — ネットワークを一覧表示/取得

• create_network / update_network — ネットワークを作成/更新

ルート

• list_routes / get_route — ファイアウォールルールを含むルートを一覧表示/取得

• create_route / update_route — ルートを作成/更新（完全置換）

• delete_route — ルートを削除

• add_route_firewall_rule — ルートにファイアウォールルールを追加

• remove_route_firewall_rule — インデックスでルートファイアウォールルールを削除

その他

• list_audit_logs — フィルター付きの監査ログ

• list_downloads — ソフトウェアダウンロードリンク（認証不要）

Claude Codeスキル

このリポジトリには、インタラクティブなネットワーク管理のためのClaude Codeスキルが含まれています。 このリポジトリからClaude Codeを実行すると、/network-architectコマンドが自動的に利用可能になります。

任意のプロジェクトからこのスキルを使用するには、Claude Codeプロファイルにコピーしてください:

cp -r .claude/skills/network-architect ~/.claude/skills/

/network-architect audit

Defined Networkingアカウントのセキュリティおよび構成監査を実行します。 すべてのネットワーク、ロール、タグ、ホストを取得し、以下を報告します:

• 不足している、または過度に寛容なファイアウォールルールを持つロール

• デッドタグ（割り当てられたホストがゼロ）

• タグがない、dnclientのバージョンが古い、または最終確認時刻が古いホスト

• ポート/プロトコル/タグの詳細を含む、ロールごとのファイアウォールカバレッジの概要

/network-architect design

インタラクティブなファイアウォールポリシー設計セッション。サービス、アクセス要件、セグメンテーションのニーズについて質問し、以下を提案します:

• ロール構造（各ホストタイプが何であるか）

• タグ分類（ssh:allowのようなアクセスタグ、user-type:adminのようなIDタグ）

• ANDロジック（ロール + タグ）を使用したテーブル形式のロールごとのファイアウォールルール

/network-architect apply

アトミックツール（add_firewall_rule、add_host_tagなど）を使用してネットワーク設計を実装します。最初に現在の状態を読み取り、差分を表示し、確認を求め、適用後に検証を行います。

ライセンス

MIT