PiHole MCP Server

@NickJLange

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

NickJLange

关于 PiHole MCP Server

暂无概览

#pihole #mcp #server #fastapi #nlp

PiHole MCP Server 配置

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

{
  "mcpServers": {
    "pihole_mcp_server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

PiHole MCP Server 工具

工具列表暂未提供

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

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

概览

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 /docs when 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

常见问题

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.

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.

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

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Sequential Thinking