🛡️ AdGuard Home MCP

🛡️ AdGuard Home MCP

AdGuard Home 用の Model Context Protocol（MCP）サーバーです。AI エージェントから、DNS リライトレコード、フィルタリングルール、フィルターリストを管理できます。

📦 インストール

npm i -g @fcannizzaro/mcp-adguard-home

⚙️ 認証情報

CLI では、次のコマンドを実行します。

adguard-cli login

AdGuard Home の URL、ユーザー名、パスワードの入力を求められ、~/.config/mcp-adguard-home/config.json に保存されます。保存済みの認証情報は起動時に自動的に読み込まれます。保存済みの認証情報がない場合、パッケージは次の環境変数を使用します。

変数	説明
ADGUARD_URL	AdGuard Home インスタンスのベース URL（例：http://192.168.1.1）
ADGUARD_USERNAME	AdGuard Home のユーザー名
ADGUARD_PASSWORD	AdGuard Home のパスワード

🚀 設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
	"mcpServers": {
		"adguard-home": {
			"command": "npx",
			"args": ["-y", "@fcannizzaro/mcp-adguard-home"],
			"env": {
				"ADGUARD_URL": "http://192.168.1.1",
				"ADGUARD_USERNAME": "admin",
				"ADGUARD_PASSWORD": "your-password"
			}
		}
	}
}

Cursor

プロジェクトのルートにある .cursor/mcp.json（またはグローバル設定の ~/.cursor/mcp.json）を編集します。

{
	"mcpServers": {
		"adguard-home": {
			"command": "npx",
			"args": ["-y", "@fcannizzaro/mcp-adguard-home"],
			"env": {
				"ADGUARD_URL": "http://192.168.1.1",
				"ADGUARD_USERNAME": "admin",
				"ADGUARD_PASSWORD": "your-password"
			}
		}
	}
}

VS Code

プロジェクトのルートにある .vscode/mcp.json を編集します。

{
	"servers": {
		"adguard-home": {
			"type": "stdio",
			"command": "npx",
			"args": ["-y", "@fcannizzaro/mcp-adguard-home"],
			"env": {
				"ADGUARD_URL": "http://192.168.1.1",
				"ADGUARD_USERNAME": "admin",
				"ADGUARD_PASSWORD": "your-password"
			}
		}
	}
}

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
	"mcpServers": {
		"adguard-home": {
			"command": "npx",
			"args": ["-y", "@fcannizzaro/mcp-adguard-home"],
			"env": {
				"ADGUARD_URL": "http://192.168.1.1",
				"ADGUARD_USERNAME": "admin",
				"ADGUARD_PASSWORD": "your-password"
			}
		}
	}
}

Claude Code CLI

claude mcp add adguard-home \
  -e ADGUARD_URL=http://192.168.1.1 \
  -e ADGUARD_USERNAME=admin \
  -e ADGUARD_PASSWORD=your-password \
  -- npx -y @fcannizzaro/mcp-adguard-home

🧰 利用可能なツール

このパッケージは、MCP を使用しないエージェントやスクリプト向けに、通常の CLI もインストールします。

adguard-cli login
adguard-cli list_rewrite_dns_records
adguard-cli add_rewrite_dns_record --domain example.test --ip 192.168.1.10
adguard-cli manage_dns_filtering_rules --domains ads.example --allowed false

CLI の引数は、JSON オブジェクトとして渡すこともできます。

adguard-cli add_rewrite_dns_record '{"domain":"example.test","ip":"192.168.1.10"}'

DNS リライトレコード

ツール	説明	パラメーター
list_rewrite_dns_records	すべての DNS リライトレコードを一覧表示します	—
add_rewrite_dns_record	DNS リライトレコードを追加します	domain: string、ip: string
remove_rewrite_dns_record	DNS リライトレコードを削除します	domain: string、ip: string

DNS フィルタリングルール

ツール	説明	パラメーター
list_dns_filtering_rules	カスタム DNS フィルタリングルールをすべて一覧表示します	—
manage_dns_filtering_rules	ドメインをブロックまたは許可します	domains: string[]、allowed: boolean
remove_rdns_filtering_rules	カスタムフィルタリングルールを削除します	domains: string[]

フィルターリスト

ツール	説明	パラメーター
list_filter_lists	設定済みのフィルターリストをすべて一覧表示します	—
toggle_filter_list	フィルターリストを有効または無効にします	id: number、enabled: boolean
refresh_filter_lists	すべてのフィルターリストを強制的に更新します	—

📄 ライセンス

MIT License の下でライセンスされています。