What does the PiHole MCP Server do?
It provides a RESTful API that lets you manage and retrieve Pi-hole statistics using natural language queries, backed by a RAG system.
PiHole MCP Server
@NickJLange
Basic information
About PiHole MCP Server
No overview available yet
PiHole MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"pihole_mcp_server": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}PiHole MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is PiHole MCP Server?
The PiHole MCP Server is a FastAPI-based RESTful service that enables natural-language query-based management and retrieval of statistics from Pi-hole devices using a Retrieval-Augmented Generation (RAG) system. It is designed for users who want to interact with their Pi-hole devices through natural language commands.
How to use PiHole MCP Server?
Clone the repository, set up a virtual environment, install dependencies from requirements.txt, and configure config.toml (with secrets in a .env file). Start the server with uvicorn main:app --host 0.0.0.0 --port 8000. Then send POST requests to the /query endpoint with an X-API-Key header and a JSON body containing the query.
Key features of PiHole MCP Server
- RESTful API built with FastAPI for interacting with Pi-hole
- Natural language query processing via a RAG system
- Feature flags configurable in
config.toml - API documentation available at
/docswhen running - Milvus database integration for retrieval-augmented generation
Use cases of PiHole MCP Server
- Block internet access for a specified duration using natural language
- Query Pi-hole statistics without manual API calls
- Automate Pi-hole management tasks through a programmable interface
Frequently asked questions
How do I install and run the server?
Clone the repo, create a Python virtual environment, run `pip install -r requirements.txt`, copy `config.toml.example` to `config.toml` and adjust settings, then execute `uvicorn main:app --host 0.0.0.0 --port 8000`.
How is authentication handled?
Requests to the `/query` endpoint must include an `X-API-Key` header containing your API key. API keys are stored in a `.env` file.
What are the dependencies required?
Dependencies are listed in the `requirements.txt` file. External services used include Pi-hole and a Milvus database for the RAG system.
Where can I find the full API documentation?
When the server is running, navigate to `/docs` in a browser to view the interactive OpenAPI documentation.
More Other MCP servers
ICSS
chokcoco不止于 CSS
20.7K
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
23.2K
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
Screenpipe
screenpipeYC (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
Comments