ローカル Loki MCP サーバー

ローカルのGrafana Lokiインスタンス向けの、小さな読み取り専用MCPサーバーです。FastAPIと公式MCP Python SDKで構築されています。

公開内容

• search_logs(service, start, end, text=None) — 必須のサービスと、必須のRFC 3339時間範囲内の任意のリテラルテキストを検索します。

• list_services(start, end) — 利用可能なサービスラベルの値を一覧表示します。

• loki_health() — Lokiの準備ができているかどうかを確認します。

公開されているツールにはlimitパラメータはありません。また、リクエストもLokiのlimitクエリパラメータを省略するため、Loki自身に設定されたデフォルト/最大値が適用されます。

Related MCP server: grafana-mcp

実行方法

1. Python 3.11以降をインストールし、仮想環境を作成して有効にします。

   py -3.11 -m venv .venv
   .\.venv\Scripts\Activate.ps1
   pip install -r requirements.txt

2. デフォルトがお使いの構成と一致しない場合は、シェルで環境変数を設定します。.env.exampleに利用可能な設定が一覧表示されています。デフォルトでは、http://127.0.0.1:3100のLokiとservice_nameラベルを想定しています。

3. サーバーを起動します。

   uvicorn main:app --reload

MCP Streamable HTTPエンドポイントはhttp://127.0.0.1:8000/mcpです。サーバー自身のヘルスエンドポイントはhttp://127.0.0.1:8000/healthです。

例

search_logsを以下のように呼び出すと:

{
  "service": "checkout",
  "text": "connection refused",
  "start": "2026-08-26T08:00:00Z",
  "end": "2026-08-26T09:00:00Z"
}

次のLogQLクエリが生成されます:

{service_name="checkout"} |= "connection refused"

ラベルにappを使用する場合は、代わりに$env:LOKI_SERVICE_LABEL = "app"を指定してサーバーを起動してください。