PiHole MCP Server

Pi-hole MCP サーバー

---

Java で実装された Pi-hole MCP（Model Control Protocol）サーバーです。AI アプリケーションが標準コマンドを通じて Pi-hole インスタンスとやり取りし、管理できます。

機能

• 主要な AI ツール
  • Restart Pi-hole FTL Service — Pi-hole FTL DNS サービスを再起動して、変更を適用するか、問題から復旧します。
  • Get Pi-hole DNS Blocking Status — 現在のブロックモードと残り時間を取得します。
  • Set Pi-hole DNS Blocking Status — DNS ブロックを有効／無効にします。オプションで無効にする時間（秒）を設定できます。
  • Add New Domain — 検証と任意のコメントを添えて、許可リスト／拒否リストにドメインを追加します（exact と regex の種類に対応）。
  • Retrive Pi-hole Statistics — クエリ総数、ブロックされたクエリ数、上位ドメインなどの統計情報を取得します。
  • Retrive Pi-hole System Information — CPU 負荷、メモリ使用量、ブロック率、稼働時間などのシステム情報を取得します。

サーバーの実行

MCP サーバーを実行するには、お使いのマシンに Java 21 がインストールされている必要があります。

1. リリースページから Pi-hole MCP サーバーの JAR ファイルをダウンロードします。
2. AI アプリケーションのクライアントに MCP サーバーの設定を追加します。

JSON 設定例：

{
  "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"
      }
    }
  }
}

YAML 設定例：

name: pihole-mcp-server-java
version: 0.0.1
schema: v1
mcpServers:
  - name: 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_PORT：Pi-hole インスタンスが実行されているポート（任意。デフォルトは 80）。
• PIHOLE_HOST：Pi-hole インスタンスの IP アドレスまたはホスト名。
• PIHOLE_APP_PASSWORD：Pi-hole インスタンスのアプリケーションパスワード。

ソースからのビルド

前提条件：

• Java JDK 21
• Maven

ソースから Pi-hole MCP サーバーをビルドするには、次の手順に従ってください。

1. リポジトリをクローン／ダウンロードします。
2. Maven を使用してプロジェクトをビルドします。

   mvn clean package
   

3. 上記のコマンドを使用してサーバーを実行します。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。