Loki MCP Server

🚀 シンプルなLoki MCPサーバー

Loki MCPサーバーは、logcli を通じてGrafana Lokiのログをクエリするための モデルコンテキストプロトコル (MCP) インターフェースです。このサーバーにより、AIアシスタントはLokiのログデータに直接アクセスし、分析することができます。

✨ 主な機能

• 完全なLogQLを使用してLokiログをクエリできます。
• ラベル値とメタデータを取得できます。
• 環境変数または設定ファイルを通じて認証と設定をサポートします。
• さまざまな出力形式（デフォルト、生データ、JSONライン）の結果を提供します。
• 環境に logcli がインストールされていない場合、自動的にHTTP APIにフォールバックします。

📦 インストール

前提条件

• Node.js v16以上
• TypeScript
• (オプション) Grafana Loki logcli がインストールされ、PATHに含まれていること。logcli が環境で使用できない場合、サーバーは自動的にLoki HTTP APIを使用します。
• 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": "node",
      "args": ["index.js"],
      "config": {
        "port": 3000,
        "logcliPath": "/usr/local/bin/logcli"
      }
    }
  }
}

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

npm start

開発モードで実行するには、以下のコマンドを実行します。

npm run dev

🔧 技術詳細

HTTP APIへの自動フォールバック

サーバーは自動的に logcli がインストールされて利用可能かどうかをチェックします。

1. logcli が利用可能な場合、すべてのクエリにそれを使用し、CLIツールと同じ完全な機能を提供します。
2. logcli が利用できない場合、サーバーは自動的にLoki HTTP APIを使用します。
   • 追加の設定は不要です。
   • 同じ認証パラメータを使用します。
   • 応答形式はCLI出力と一致します。
   • 各クエリはデフォルトで1000件のログに制限されます。

この自動検出により、サーバーは手動での設定なしでさまざまな環境でシームレスに動作します。

📄 ライセンス

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