log

@rog0x/mcp-log-tools

MCP（Model Context Protocol）を介して公開される、AI エージェント向けのログ分析・処理ツールです。

ツール

parse_logs

JSON ログ、Apache/Nginx アクセスログ、syslog、構造化ログなど、一般的な形式のログコンテンツを解析します。名前付きキャプチャグループを使用したカスタム正規表現パターンに対応しています。タイムスタンプ、レベル、メッセージ、ソース、その他の構造化フィールドを抽出します。

filter_logs

解析済みのログエントリを、次の条件でフィルタリングします。

• ログレベル（ERROR、WARN、INFO、DEBUG）
• 日付範囲（ISO 8601）
• キーワード検索（大文字と小文字を区別しません）
• 正規表現パターンによる照合
• ソース／ロガー名

一致したエントリと、レベルごとの出現回数を返します。

analyze_logs

ログパターンを分析し、運用上の知見を明らかにします。

• 発生頻度の高いエラー上位10件（正規化済み）
• 時間ごとのエラー率
• 時間ごとのリクエスト数
• 最も遅いエンドポイント（HTTP アクセスログから取得）
• 異常検出（標準偏差を用いて急激な増減を検出）

format_logs

ログ形式を変換し、レポートを作成します。

• JSON からプレーンテキスト、プレーンテキストから JSON、CSV、またはテーブルへの変換
• ログレベルに応じた ANSI カラー表示
• 構造化フィールドの抽出
• サマリーレポートの生成

log_stats

包括的なログ統計を計算します。

• 行の合計数と空でない行数
• 割合を含むレベルの分布
• 日付範囲の対象期間
• 一意な IP アドレスとリクエスト数
• ユーザーエージェントの上位
• HTTP ステータスコードの分布
• スループット（1 秒あたりのエントリ数）

セットアップ

npm install
npm run build

Claude Desktop での使用方法

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "log-tools": {
      "command": "node",
      "args": ["path/to/mcp-log-tools/dist/index.js"]
    }
  }
}

対応ログ形式

形式	例
JSON	{"timestamp":"2024-01-15T10:30:00Z","level":"ERROR","message":"Connection failed"}
Apache/Nginx	127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET /index.html HTTP/1.1" 200 2326
Syslog	Jan 1 00:00:00 hostname process[1234]: Something happened
構造化ログ	2024-01-15T10:30:00.000Z [ERROR] [ModuleName] Something failed
カスタム	名前付きキャプチャグループを含む正規表現を使用した任意の形式

ライセンス

MIT