AI导哈

DNS网络监控分析工具

Pi-hole MCP Server是一款结合AI技术的DNS网络监控工具，提供网络活动监控、域名智能分析和安全调查功能，适用于家庭网络安全和隐私保护。

  • by ajinux
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 ajinux/pi-hole-mcp-server

使用说明

🛡️ Pi hole MCP服务器

使用AI驱动的OSINT监控您的家庭网络并调查可疑域

🎯 为什么是这个项目？

构建用于监控家庭网络活动并使用AI调查DNS查询。将Pi hole的DNS级别可见性与域智能（DNS记录、WHOIS查找）相结合，以快速分析网络行为，出于安全目的调查可疑活动，或简单地了解您的设备连接到什么——所有这些都是通过自然语言AI查询实现的。

✨ 特性

Pi hole集成（网络统计、客户端监控、域分析）+增强的域智能（DNS记录、WHOIS、OSINT提示）+通过MCP进行AI驱动的分析

🚀 安装

快速安装（推荐）

curl -fsSL https://raw.githubusercontent.com/ajinux/pi-hole-mcp-server/main/install.sh | sh
Build from Source

1.克隆存储库

git clone https://github.com/ajinux/pi-hole-mcp-server.git
cd pi-hole-mcp-server

2.安装依赖项

go mod download

3.构建服务器

make build

▶️ 跑

 $ pihole-mcp
2025/12/14 17:40:39 starting pihole-mcp version=v0.1.0-dirty commit=961ceed built=2025-12-14T11:54:53Z
2025/12/14 17:40:40 obtained a new pi-hole session token successfully
2025/12/14 17:40:40 Starting Pi-hole MCP server on http://localhost:8081
2025/12/14 17:40:40 Connected to Pi-hole at: http://192.168.0.111/api

⚙️ 配置

创建 .env file或将其设置为env或将其作为arg传递（检查pihole mcp--help）：

PIHOLE_URL=http://192.168.1.100:83/api
PIHOLE_PASSWORD=your_pihole_api_password
PORT=8081 #mcp server port

您可以使用pi电话管理仪表板获取新密码

注： 此服务器使用流式HTTP传输。相应地配置您的MCP客户端（有关客户端特定的设置，请参阅MCP文档）

🔧 可用工具

1. get_top_active_clients

按DNS查询量获取最活跃的设备。返回IP、名称、查询计数、MAC地址/供应商。

2. get_top_domains_for_client

分析来自特定IP的DNS查询。参数： client_ip （必填）， hours （默认值：24）， count （默认值：10）。

3. get_top_domains

获取所有设备上查询最多的域（允许+阻止）。

4. get_domain_dns_records

获取任何域的DNS记录（A、AAAA、NS、MX、TXT）。自动从子域中提取TLD。

5. get_domain_whois

WHOIS查找域名注册信息（注册商、日期、所有者详细信息）。自动从子域中提取TLD。

💬 可用提示

domain-osint

综合OSINT分析，结合DNS记录、WHOIS数据、托管基础设施、电子邮件安全配置（SPF/DKIM/DMARC）和域历史，以识别安全问题。

📚 查询示例

  • “显示前10个最活跃的设备”
  • “ip为192.168.1.50的设备在过去6小时内查询了哪些域？”
  • “使用OSINT调查可疑网站”
  • “获取WHOIS信息，例如.com”

🙏 致谢

多亏了 Pi孔开发人员 对于网络范围的广告拦截解决方案， 李西安 对于WHOIS套餐

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

📞 支持

问题 • 拉取请求

由...制作❤️ 用于家庭网络安全和隐私

相关 MCP