mcp-server-logs-sieve

mcp-server-logs-sieveは、AIアシスタントがオブザーバビリティのバックエンドから直接ログをクエリできるようにするMCPサーバーです。

デバッグに関する質問を自然言語で行えば、Logs Sieveが必要なログとコンテキストを正確に取得します。

なぜこれが必要なのか

インシデント発生時、以下のような反復的な作業に多くの時間が費やされます：

• 適切なログソースの特定

• 時間枠の絞り込み

• 繰り返される障害パターンの発見

• サービスをまたいだトレースの追跡

Logs Sieveは、これらのワークフローをquery_logs、summarize_logs、trace_request、list_log_sourcesという4つのツールにパッケージ化します。

Related MCP server: Azure Logs MCP

対応プロバイダー

• Google Cloud Logging (gcp)

• AWS CloudWatch Logs (aws)

• Azure Monitor Logs (azure)

• Grafana Loki (loki)

• Elasticsearch (elasticsearch)

前提条件

⚠️ Node.js 20以上が必要です。

このパッケージはESモジュールとNode.js 20+を必要とする依存関係を使用しています。ERR_MODULE_NOT_FOUNDエラーが表示される場合は、node -vでNodeのバージョンを確認し、必要に応じてアップグレードしてください。

これはnpx経由での実行、グローバルインストール、ソースからの使用のいずれの場合にも適用されます。

MCP設定のクイックスタート

.mcp.jsonの例：

{
  "mcpServers": {
    "logs-sieve": {
      "command": "npx",
      "args": ["-y", "mcp-server-logs-sieve@latest", "--provider", "gcp"]
    }
  }
}

このリポジトリのソースから直接実行する場合でも、node ./bin/mcp-server-logs-sieve.js --provider gcpのように使用できます。

初回セットアップ: 初回使用時、npxはパッケージのダウンロードとインストールを行う必要があります（約40秒）。Claude Codeがこれを待機中にタイムアウトする可能性があります。MCP設定に追加する前に、ターミナルで一度以下を実行してキャッシュを準備してください：

npx mcp-server-logs-sieve@latest --provider gcp
# (Ctrl+C once it starts — you just need the install to complete)

その後は、Claude Codeがnpxキャッシュから即座にサーバーを起動します。

設定を更新した後、MCPクライアントを再起動し、/mcpで確認してください。

プロバイダーの認証と環境変数

プロバイダー固有のセットアップおよび認証ドキュメントを参照してください：

• GCP

• AWS

• Azure

• Loki

• Elasticsearch

Elasticsearch API互換ヘッダーについては以下を参照してください：

export ELASTICSEARCH_COMPAT_VERSION=8

CLIの使用方法

このパッケージには、ターミナルで直接使用するためのCLIも含まれています：

mcp-server-logs-sieve query --provider gcp --scope my-project --last 1h --filter "payment failed"
mcp-server-logs-sieve summarize --provider gcp --scope my-project --last 24h
mcp-server-logs-sieve trace --provider gcp --scope my-project --trace <trace-id>
mcp-server-logs-sieve sources --provider gcp --scope my-project

ドキュメント

• ドキュメントホーム

• はじめに

• MCPクライアント設定 (Claude Code, Claude Desktop, Cursor, Windsurf)

• ツールリファレンス

• トラブルシューティング

• 互換性マトリックス

コントリビューション

コントリビューションを歓迎します。

• はじめに: CONTRIBUTING.md

• Issue: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/issues

• ディスカッション: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/discussions