广告合作
MCP.so
登录

PiHole MCP Server

@JafarKhQ

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

JafarKhQ

提交者

Jafar Qaddoumi

关于 PiHole MCP Server

Manage Pi-hole with the power of AI

#pihole#dns#privacy

PiHole MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "pihole-mcp-server-java": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/pihole-mcp.jar"
      ],
      "env": {
        "PIHOLE_PORT": "8080",
        "PIHOLE_HOST": "192.168.1.2",
        "PIHOLE_APP_PASSWORD": "your_app_password"
      }
    }
  }
}

PiHole MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is PiHole MCP Server?

PiHole MCP Server is a Java-based MCP (Model Context Protocol) server that enables AI applications to manage a Pi-hole instance through standard commands. It is designed for users who want to control Pi-hole DNS blocking, domain lists, and retrieve statistics from an AI assistant.

How to use PiHole MCP Server?

Ensure Java 21 is installed, download the JAR from the releases page, and configure your AI client with the server command (java -jar /path/to/pihole-mcp.jar) and environment variables (PIHOLE_HOST, PIHOLE_APP_PASSWORD, and optionally PIHOLE_PORT). Then, restart the client to make the tools available.

Key features of PiHole MCP Server

  • Restart the Pi-hole FTL DNS service.
  • Get or set DNS blocking status with optional disable timer.
  • Add domains to allowlist or denylist (exact or regex).
  • Retrieve Pi-hole statistics (total queries, blocked, top domains).
  • Fetch system information (CPU, memory, blocking percentage, uptime).

Use cases of PiHole MCP Server

  • Enable or disable Pi-hole ad blocking from an AI chat interface.
  • Automatically add suspicious domains to the denylist via AI workflow.
  • Monitor Pi-hole performance and query statistics in real time.
  • Quickly restart the FTL service when troubleshooting network issues.

常见问题

1

What does PiHole MCP Server do?

It acts as a bridge between AI applications and a Pi-hole instance, exposing tools to manage DNS blocking, domain lists, and retrieve statistics.

2

What are the system requirements?

Java 21 must be installed on the machine running the server. The Pi-hole instance must be reachable over the network.

3

How do I connect it to my Pi-hole?

Set the environment variables `PIHOLE_HOST` (IP or hostname), `PIHOLE_APP_PASSWORD` (your Pi-hole application password), and optionally `PIHOLE_PORT` (default 80).

4

Does it support authentication?

Yes, it uses the Pi-hole application password provided via the `PIHOLE_APP_PASSWORD` environment variable.

5

What commands can the AI send?

The server exposes six tools: restart FTL, get/set blocking status, add a domain, retrieve statistics, and retrieve system information.

评论

其他 分类下的更多 MCP 服务器

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

ICSS

chokcoco

不止于 CSS

20.7K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
广告合作