返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端