Loki MCP

🚀 Loki MCP サーバー

Loki MCP サーバーは、Grafana Loki と統合するためのツールです。コマンドラインまたは設定を通じて相互作用できます。以下にこのプロジェクトの詳細ドキュメントを示します。

🚀 クイックスタート

📦 インストール

Loki MCP サーバーを使用するには、以下の手順に従ってください。

1. リポジトリをクローンする：

   git clone https://github.com/your-repository.git
   cd loki-mcp-server
   

2. バイナリファイルをビルドする（オプション）：

   go build -o loki-mcp-server ./cmd/server
   

3. サーバーを起動する：

   ./loki-mcp-server
   

🔧 プロジェクト構造

• cmd/server: MCP サーバーのメインプログラムが含まれています。
• internal/handlers/loki.go: Grafana Loki クエリ機能の実装です。
• internal/handlers/types.go: ハンドラーの汎用型とインターフェースを定義しています。

💻 使用例

コマンドライン引数

Loki MCP サーバーは、以下のコマンドライン引数をサポートしています。

• -config: 設定ファイルのパスを指定します（デフォルトは config.json）。
• -log.level: ログレベルを設定します（選択可能な値: debug, info, warning, error）。

基本的な使用法

1. Loki データをクエリする：

   ./loki-mcp-server query --expr "{job=\"varlogs\"}"
   

2. Loki のログを取得する：

   ./loki-mcp-server logs -selector "job=varlogs"
   

Docker サポート

イメージのビルド

# Dockerfile
FROM golang:1.20 AS builder

WORKDIR /app
COPY go.mod .
COPY go.sum .
RUN go mod tidy

COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o loki-mcp-server ./cmd/server

FROM alpine:3.18
WORKDIR /app
COPY --from=builder /app/loki-mcp-server .

CMD ["./loki-mcp-server"]

コンテナの実行

docker build -t loki-mcp-server .
docker run -it loki-mcp-server

Claude Desktop との統合

Claude Desktop で Loki MCP サーバーを使用するには、以下の手順に従ってください。

1. バイナリファイルをビルドする：

   go build -o loki-mcp-server ./cmd/server
   

2. 設定ファイルの例（claude_desktop_config.json）：

   {
     "mcpServers": {
       "lokiserver": {
         "command": "path/to/loki-mcp-server",
         "args": [],
         "env": {
           "LOKI_URL": "http://localhost:3100"
         },
         "disabled": false,
         "autoApprove": ["loki_query"]
       }
     }
   }
   

3. 設定ファイルの場所：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

Cursor との統合

Cursor で Loki MCP サーバーを使用するには、設定ファイルに以下の内容を追加してください。

{
  "mcpServers": {
    "loki-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "LOKI_URL=http://host.docker.internal:3100", "loki-mcp-server:latest"]
    }
  }
}

📄 ライセンス

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

もし何か問題があれば、Issue または Pull Request を投稿してください。