mcpField
L
log-analyzer-mcp

log-analyzer-mcp

ローカル
github.com/Fato07データ・分析541 週間前に更新
リポジトリ

log-analyzer-mcp について

Log Analyzer MCPは、Claude Code向けのログ分析・デバッグサーバーです。形式の判別、コンテキスト付き検索、エラーの分類、複数ファイル間のイベント照合ができます。

主な機能

  1. 019種類以上のログ形式を自動判別
  2. 02正規表現・時刻・コンテキストによる検索
  3. 03エラーの抽出と類似項目の分類
  4. 04複数ファイル間のイベント照合
  5. 05個人情報・認証情報・シークレットのスキャン
  6. 06全体を読み込まず大容量ファイルをストリーミング処理

活用シーン

  1. 01アプリケーションログのエラー抽出と分類
  2. 02OutOfMemoryError直前のイベント追跡
  3. 03ログに誤って記録された認証情報の確認

MCP 対応

このMCPサーバーは、ログ解析・検索・エラー抽出・要約・イベント照合・監視・自然言語クエリ・機密データスキャンのツールをMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "fato07-log-analyzer": {
      "command": "uvx",
      "args": [
        "codesdevs-log-analyzer"
      ]
    }
  }
}
起動コマンドuvx codesdevs-log-analyzer

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypicodesdevs-log-analyzer0.4.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Log Analyzer MCP

MCP Registry PyPI version PyPI Downloads License: MIT Python 3.10+ GitHub stars

🔍 ログをAIにコピー＆ペーストするのはもうやめましょう。 Claudeに直接読み取らせましょう。

AIを活用したログ分析用のMCPサーバーです。Claude Codeから、9種類以上の形式のログファイルを解析、検索、デバッグできます。

📊 概要

14 個のMCPツール9+ 種類のログ形式
280 件のテスト81%+ のカバレッジ

🎬 デモ

Log Analyzer MCP Demo

14個の専門ツールでログを分析

🤔 なぜ使うのか？

log-analyzer-mcpを使わない場合log-analyzer-mcpを使う場合
ログの一部をコピー＆ペーストするClaudeにファイルを指定する
貼り付けるたびにコンテキストが失われるファイル全体にアクセスできる
手作業で形式を解析する自動検出
関連するエラーを見落とすスマートに関連付ける

✨ 特長

  • 自動検出 — 9種類以上の一般的なログ形式から形式を特定します
  • スマート検索 — コンテキスト、正規表現、時間フィルタリングを使ったパターンマッチング
  • エラー抽出 — 類似エラーをグループ化し、スタックトレースを取得します
  • 自然言語 — 「今日発生したエラーは？」のような質問ができます
  • 機密データのスキャン — 個人情報、認証情報、シークレットを検出します
  • 複数ファイルの分析 — 分散システム全体のイベントを関連付けます
  • ストリーミング — メモリの問題なく1GB以上のファイルを処理します

🚀 クイックスタート

# Install (adds to Claude Code automatically)
uvx codesdevs-log-analyzer install

次に、Claude Codeで：

Analyze /var/log/app.log and tell me what's causing the errors

📦 インストール

ワンライナー（推奨）
uvx codesdevs-log-analyzer install
手動
pip / uv / Claude Code の設定 
# pip
pip install codesdevs-log-analyzer

# uv
uv tool install codesdevs-log-analyzer

~/.claude/settings.json に追加します：

{
  "mcpServers": {
    "log-analyzer": {
      "command": "uvx",
      "args": ["codesdevs-log-analyzer"]
    }
  }
}

📋 対応形式

形式例
SyslogJan 15 10:30:00 hostname process[pid]: message
Apache/Nginx127.0.0.1 - - [15/Jan/2026:10:30:00] "GET /path" 200
JSON Lines{"timestamp": "...", "level": "ERROR", "message": "..."}
Docker2026-01-15T10:30:00.123Z stdout message
Python2026-01-15 10:30:00,123 - module - ERROR - message
Java/Log4j2026-01-15 10:30:00,123 ERROR [thread] class - message
Kuberneteslevel=error msg="..." ts=2026-01-15T10:30:00Z
汎用認識可能なタイムスタンプを含む任意の行

⚡ パフォーマンス

指標値
100MBのログファイル10秒未満
メモリ使用量ストリーミング（全体を読み込みません）
最大テスト済みサイズ1GB以上
形式の検出100ms未満

🛠️ 利用可能なツール

ツール説明
log_analyzer_parse形式を検出し、メタデータを抽出します
log_analyzer_searchコンテキスト行を含めて検索します
log_analyzer_extract_errorsエラーを抽出してグループ化します
log_analyzer_summarizeデバッグ用の要約を生成します
log_analyzer_correlate関連するイベントを見つけます
log_analyzer_watch新しいエントリを監視します
log_analyzer_ask自然言語で質問します
log_analyzer_scan_sensitive個人情報／認証情報を検出します
+ 6 個全リファレンス →

💡 使用例

エラーを見つける：

Extract all errors from /var/log/app.log, group similar ones

コンテキストを含めて検索する：

Search for "timeout" in app.log with 5 lines of context

イベントを関連付ける：

What happened 60 seconds before each OutOfMemoryError?

シークレットをスキャンする：

Check /var/log/app.log for accidentally logged credentials

🔧 開発

git clone https://github.com/Fato07/log-analyzer-mcp
cd log-analyzer-mcp
uv sync
uv run pytest -v --cov

📈 スター履歴

Star History Chart

📄 License

MIT License - see LICENSE for details.

Found this useful? Give it a ⭐ on GitHub!

Report bugs · Request features · Discussions · Full docs

Built by Fato07 at CodesDevs

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。