mcp-victorialogs

VictoriaLogs MCP サーバー

ライセンススラックレディット

VictoriaLogs用のモデルコンテキストプロトコル (MCP)サーバーの実装。

これにより、VictoriaLogsインスタンスへのアクセスと、 VictoriaLogs APIおよびドキュメントとのシームレスな統合が可能になります。VictoriaLogsインスタンスに関連するログ、可観測性、デバッグタスクのための包括的なインターフェースを提供し、エンジニアやツールのための高度な自動化およびインタラクション機能を実現します。

特徴

この MCP サーバーを使用すると、VictoriaLogs のほぼすべての読み取り専用 API、つまりWeb UIで使用できるすべての機能を使用できます。

ログのクエリとログデータの探索
VictoriaLogsインスタンスのパラメータを表示しています
利用可能なストリーム、フィールド、フィールド値の一覧
ログの統計情報をメトリクスとしてクエリする

さらに、MCP サーバーには最新のドキュメントが埋め込まれており、オンラインアクセスなしで検索できます。

使用可能なツールとプロンプトの詳細については、「使用方法」セクションを参照してください。

ツールの機能やプロンプト内のドキュメント検索機能を組み合わせることで、VictoriaLogsインスタンスの優れた利用シナリオを構築できます。MCPサーバーとそのレスポンスの品質は、クライアントの能力と使用するモデルの品質に大きく依存することにご注意ください。

MCP サーバーを他の可観測性またはドキュメント検索関連の MCP サーバーと組み合わせて、さらに強力な結果を得ることもできます。

要件

VictoriaLogsインスタンス (単一ノードまたはクラスター)
Go 1.24以上（ソースからビルドする場合）

インストール

行く

go install github.com/VictoriaMetrics-Community/mcp-victorialogs/cmd/mcp-victorialogs@latest

ソースコード

git clone https://github.com/VictoriaMetrics-Community/mcp-victorialogs.git
cd mcp-victorialogs
go build -o bin/mcp-victorialogs ./cmd/mcp-victorialogs/main.go

# after that add bin/mcp-victorialogs file to your PATH

バイナリ

リリースページから最新リリースをダウンロードし、PATH に配置するだけです。

ドッカー

近日公開...

鍛冶屋

Smithery経由でクライアントに VictoriaLogs MCP Server を自動的にインストールするには、次のコマンドを使用できます。

# Get the list of supported MCP clients
npx -y @smithery/cli list clients
#Available clients:
#  claude
#  cline
#  windsurf
#  roocode
#  witsy
#  enconvo
#  cursor
#  vscode
#  vscode-insiders
#  boltai
#  amazon-bedrock

# Install VictoriaLogs MCP server for your client
npx -y @smithery/cli install @VictoriaMetrics-Community/mcp-victorialogs --client <YOUR-CLIENT-NAME>
# and follow the instructions

構成

VictoriaLogs の MCP サーバーは、環境変数を介して構成されます。

変数	説明	必須	デフォルト	許容値
`VL_INSTANCE_ENTRYPOINT`	VictoriaLogsインスタンスへのURL	はい	-	-
`VL_INSTANCE_BEARER_TOKEN`	VictoriaLogs API の認証トークン	いいえ	-	-
`MCP_SERVER_MODE`	サーバー動作モード	いいえ	`stdio`	`stdio` 、 `sse`
`MCP_SSE_ADDR`	SSEサーバがリッスンするアドレス	いいえ	`:8081`	-

設定例

# For a public playground
export VL_INSTANCE_ENTRYPOINT="https://play-vmlogs.victoriametrics.com"

# Server mode
export MCP_SERVER_MODE="sse"
export MCP_SSE_ADDR="0.0.0.0:8081"

クライアントでの設定

カーソル

Settings -> Cursor Settings -> MCP -> Add new global MCP serverに移動し、次の構成をカーソルの~/.cursor/mcp.jsonファイルに貼り付けます。

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

詳細については、カーソル MCP のドキュメントを参照してください。

クロードデスクトップ

これを Claude Desktop のclaude_desktop_config.jsonファイルに追加します ( Settings -> Developer -> Edit configを開くと見つかります)。

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

詳細については、 Claude Desktop MCP のドキュメントを参照してください。

クロード・コード

次のコマンドを実行します。

claude mcp add victorialogs -- /path/to/mcp-victorialogs \
  -e VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> \
  -e VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN>

詳細については、 Claude Code MCP のドキュメントを参照してください。

ビジュアルスタジオコード

VS Code MCP 構成ファイルに以下を追加します。

{
  "servers": {
    "victorialogs": {
      "type": "stdio",
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

詳細については、 VS Code MCP ドキュメントを参照してください。

ゼッド

Zed 構成ファイルに次の内容を追加します。

  "context_servers": {
    "victorialogs": {
      "command": {
        "path": "/path/to/mcp-victorialogs",
        "args": [],
        "env": {
          "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
          "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
        }
      },
      "settings": {}
    }
  }
}

詳細については、 Zed MCP のドキュメントを参照してください。

JetBrains IDE

Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)を開きます。
Add (+)クリック
As JSON選択
入力フィールドに次の内容を入力します。

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

ウィンドサーフィン

Windsurf MCP 構成ファイルに以下を追加します。

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

詳細については、 Windsurf MCP のドキュメントを参照してください。

アマゾンの岩盤

近日公開....

バイナリの代わりにDockerを使用する

近日公開...

使用法

MCP サーバーをインストールして構成したら、お気に入りの MCP クライアントで使用を開始できます。

次のフレーズから AI アシスタントとの対話を開始できます。

Use MCP VictoriaLogs in the following answers

ただし、必須ではありません。質問を開始するだけで、アシスタントが自動的にツールとドキュメントを使用して最適な回答を提供します。

ツールセット

MCP VictoriaLogs は、VictoriaLogs インスタンスと対話するためのさまざまなツールを提供します。

利用可能なツールのリストは次のとおりです。

道具	説明
`documentation`	埋め込まれたVictoriaLogsドキュメントを検索
`facets`	各ログフィールドの最も頻繁な値
`field_names`	クエリのフィールド名のリスト
`field_values`	クエリのフィールド値のリスト
`flags`	VictoriaLogsインスタンスのデフォルト以外のフラグを表示する
`hits`	バケットごとにグループ化された一致するログエントリの数
`query`	LogsQLクエリを実行する
`stats_query`	指定された時間のログ統計を照会する
`stats_query_range`	指定された時間範囲のログ統計を照会する
`stream_field_names`	クエリのストリームフィールドのリスト
`stream_field_names`	クエリのストリームフィールド値のリスト
`stream_ids`	クエリのストリームIDのリスト
`streams`	クエリのストリームのリスト

プロンプト

サーバーには、一般的なタスク用の事前定義されたプロンプトが含まれています。

これらは現時点では単なる例であり、プロンプトライブラリは将来追加される予定です。

プロンプト	説明
`documentation`	VictoriaLogs ドキュメントで特定のトピックを検索

免責事項

AIサービスやエージェント、そしてこのようなMCPサーバーは、結果の正確性、完全性、信頼性を保証するものではありません。AIで得られた結果は、ご自身で再確認する必要があります。MCPサーバーとその応答の品質は、クライアントの能力と使用するモデルの品質に大きく依存します。

貢献

MCP VictoriaLogs プロジェクトへの貢献を歓迎します。問題、機能リクエスト、プルリクエストなど、お気軽にご提出ください。