AI导哈

AdGuard Home DNS管理协议

通过AI代理管理AdGuard Home的DNS重写记录、过滤规则和过滤列表的模型上下文协议服务器。

  • by fcannizzaro
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 fcannizzaro/mcp-adguard-home

使用说明

🛡️ AdGuard主页MCP

A. 模型上下文协议 （MCP）服务器 AdGuard主页.通过AI代理管理DNS重写记录、过滤规则和过滤列表。

📦 安装

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

⚙️ 凭证

对于CLI，运行：

adguard-cli login

这会提示您输入AdGuard主页URL、用户名和密码，然后将它们保存到 ~/.config/mcp-adguard-home/config.json。启动时会自动加载已保存的凭据。如果没有保存的凭据可用，则包将回退到以下环境变量：

变量 描述
ADGUARD_URL AdGuard主页实例的基本URL（例如。 http://192.168.1.1)
ADGUARD_USERNAME AdGuard主页用户名
ADGUARD_PASSWORD AdGuard主页密码

🚀 配置

克劳德桌面版

编辑 ~/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/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"
			}
		}
	}
}

帆板运动

编辑 ~/.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"
			}
		}
	}
}

克劳德代码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许可证.

相关 MCP