🛡️ AdGuard Home MCP

A Model Context Protocol (MCP) server implementation for AdGuard Home. Easily query and manage DNS records, filtering rules, and more via AI agents.

🚀 Quick Start with Smithery.ai

This server is ready to deploy on Smithery.ai! Simply upload this repository and configure your AdGuard Home credentials.

Configuration Required:

• AdGuard Username: Your AdGuard Home admin username
• AdGuard Password: Your AdGuard Home admin password
• AdGuard URL: Base URL of your AdGuard Home instance (e.g., http://localhost:3000)

📦 Local Installation

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

⚙️ Configuration

Set the following environment variables:

ADGUARD_USERNAME=
ADGUARD_PASSWORD=
ADGUARD_URL=

🚀 Usage

Configure your MCP client to use mcp-adguard-home (it's a stdio server).

🧰 Rewrite DNS Tools

• 📋 List records (list_rewrite_dns_records)
• ➕ Add record (add_rewrite_dns_record)
• ❌ Delete record (remove_rewrite_dns_record)

🔧 DNS Filtering Tools

• 📝 List rules (list_dns_filtering_rules)
• 🔧 Add/Update rules (manage_dns_filtering_rules)
• ❌ Delete rules (remove_dns_filtering_rules)

🔧 Development with Smithery CLI

# Install Smithery CLI globally
npm install -g @smithery/cli

# Start development server
npm run dev

# Build for production
npm run smithery:build

⚙️ Local Configuration (Environment Variables)

# AdGuard Home configuration
ADGUARD_USERNAME=
ADGUARD_PASSWORD=
ADGUARD_URL=

# Smithery CLI configuration
SMITHERY_PORT=3000
SMITHERY_HOST=localhost

📄 License

Licensed under the MIT License.