シンプルなLoki MCPサーバー

Loki MCPサーバーは、 logcliを使用してGrafana Lokiログを照会するためのモデルコンテキストプロトコル（MCP）インターフェースです。このサーバーにより、AIアシスタントはLokiのログデータに直接アクセスして分析できるようになります。

特徴

完全な LogQL サポートを使用して Loki ログをクエリする
ラベル値とメタデータを取得する
環境変数または設定ファイルによる認証と設定のサポート
さまざまな出力形式（デフォルト、生データ、JSON 行）でフォーマットされた結果を提供します。

前提条件

Node.js v16以上
タイプスクリプト
Grafana Loki logcliがインストールされ、PATH でアクセス可能
Loki サーバーインスタンスへのアクセス

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Simple Loki MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude

MCP用

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "https://loki.sup.band"
      }
    }
  }
}

npm

リポジトリをクローンします。

git clone https://github.com/ghrud92/loki-mcp.git
cd loki-mcp

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

利用可能なMCPツール

クエリロキ

フィルタリングオプションを使用して Loki からログをクエリします。

パラメータ:

query （必須）: Lokiクエリ文字列（LogQL）
from : 開始タイムスタンプ（例： "2023-01-01T12:00:00Z"）
to : 終了タイムスタンプ（例： "2023-01-01T13:00:00Z"）
limit : 返されるログの最大数
batch : クエリ結果のバッチサイズ
output : 出力形式（"default"、"raw"、または "jsonl"）
quiet : クエリメタデータを抑制する
forward : 結果を時系列順に表示します

ラベル値の取得

特定のラベルのすべての値を取得します。

パラメータ:

label （必須）: 値を取得するラベル名

ラベルを取得する

利用可能なすべてのラベルを取得します。

パラメータは必要ありません。

構成

Loki アクセスは以下を使用して設定できます。

環境変数

LOKI_ADDR : Lokiサーバーのアドレス（URL）
LOKI_USERNAME : 基本認証のユーザー名
LOKI_PASSWORD : 基本認証のパスワード
LOKI_TENANT_ID : マルチテナントLokiのテナントID
LOKI_BEARER_TOKEN : 認証用のベアラートークン
LOKI_BEARER_TOKEN_FILE : ベアラートークンを含むファイル
LOKI_CA_FILE : TLS 用のカスタム CA ファイル
LOKI_CERT_FILE : TLSのクライアント証明書ファイル
LOKI_KEY_FILE : TLSのクライアントキーファイル
LOKI_ORG_ID : 複数組織設定の組織ID
LOKI_TLS_SKIP_VERIFY : TLS検証をスキップする（「true」または「false」）
LOKI_CONFIG_PATH : 設定ファイルへのカスタムパス
DEBUG : デバッグログを有効にする

設定ファイル

または、次のいずれかの場所にlogcli-config.yamlファイルを作成します。

LOKI_CONFIG_PATHで指定されたカスタムパス
現在の作業ディレクトリ
ホームディレクトリ ( ~/.logcli-config.yaml )

設定ファイルの例:

addr: https://loki.example.com
username: user
password: pass
tenant_id: mytenant

使用法

サーバーを起動します。

npm start

開発の場合:

npm run dev

発達

# Run linter
npm run lint

# Fix linting issues
npm run lint:fix

# Run tests
npm run test

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSE.mdファイルを参照してください。

Integrations