MCP.so
登录

pihole-mcp-serer MCP Server

@sbarbett

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

sbarbett

关于 pihole-mcp-serer MCP Server

A Model Context Protocol (MCP) server for Pi-hole

pihole-mcp-serer MCP Server 配置

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

{
  "mcpServers": {
    "pihole-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "dev",
        "main.py"
      ]
    }
  }
}

pihole-mcp-serer MCP Server 工具

工具列表暂未提供

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

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

概览

What is 🍓 pihole-mcp-serer?

The 🍓 pihole-mcp-serer is a Model Context Protocol (MCP) server that exposes Pi-hole functionality as tools for AI assistants. It allows AI tools to manage local DNS records, query DNS history, and retrieve metrics from one or multiple Pi-hole instances.

How to use 🍓 pihole-mcp-serer?

Create a .env file with PIHOLE_URL and PIHOLE_PASSWORD (and optionally up to three additional Pi-holes). Run the server via Docker (docker-compose up -d) for production or with uv run mcp dev main.py for development. Then configure an MCP client (e.g., Goose or Claude Desktop) to connect to the SSE endpoint at http://localhost:8383/sse.

Key features of 🍓 pihole-mcp-serer

  • Manage local DNS A and CNAME records
  • Query recent DNS query history
  • Get query filter suggestions
  • Retrieve activity graph data over time
  • Support up to four Pi-hole instances
  • Deploy with Docker for easy production use

Use cases of 🍓 pihole-mcp-serer

  • Ask an AI assistant to list all local DNS records
  • Add a new local A record via a chat interface
  • Remove a misconfigured CNAME record
  • Query recent DNS lookups for troubleshooting
  • Monitor Pi-hole activity through a conversational agent

常见问题

1

What are the dependencies?

Docker is required for production deployment. For development, `uv` is optional to run the server locally.

2

How do I configure multiple Pi-holes?

Add `PIHOLE2_URL`, `PIHOLE2_PASSWORD`, and optionally `PIHOLE2_NAME` in the `.env` file. Repeat for up to four Pi-holes.

3

How do I run the server without Docker?

Use `uv run mcp dev main.py` after installing `uv` and any required dependencies.

4

What transport protocol does it use?

The server uses SSE (Server-Sent Events) on port 8383 by default. Clients like Goose connect directly; Claude Desktop uses a proxy (`mcp-remote`) to bridge STDIO to SSE.

5

How does authentication work?

Credentials are set via environment variables (`PIHOLE_URL`, `PIHOLE_PASSWORD`) in the `.env` file. No other authentication mechanism is documented.

评论

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