shield_lock
JinDaGe
Contact
← Back to MCP directory
publicPublicdnsLocal runtime

mcp-adguard-home

AdGuard Home的MCP服务器实现，支持通过AI代理查询和管理DNS记录、过滤规则等。

article

README

🚀 🛡️ AdGuard 家庭 MCP

AdGuard 家庭 MCP 是一个为 AdGuard Home 实现的 Model Context Protocol (MCP) 服务器。借助它，你可以轻松通过 AI 代理查询和管理 DNS 记录、过滤规则等。

npm 版本 CI: 发布包

🚀 快速开始

📦 安装

npm i -g %40fcannizzaro%2Fmcp-adguard-home

⚙️ 配置

设置以下环境变量：

ADGUARD_USERNAME=  # AdGuard 账户用户名
ADGUARD_PASSWORD=  # AdGuard 账户密码
ADGUARD_URL=       # AdGuard Home 的 URL 地址

🚀 使用方法

配置您的 MCP 客户端以使用 mcp-adguard-home（这是一个基于标准输入输出的服务器）。

AdGuard Home

🧰 DNS 工具

  • 📋 列出记录 (list_rewrite_dns_records)
  • ➕ 添加记录 (add_rewrite_dns_record)
  • ❌ 删除记录 (remove_rewrite_dns_record)

🔧 DNS 过滤工具

  • 📝 列出规则 (list_dns_filtering_rules)
  • 🔧 管理规则 (manage_dns_filtering_rules)
  • ❌ 删除规则 (remove_dns_filtering_rules)

📄 许可证

本项目采用 MIT License 许可。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client