MCP Server: Analyze & Debug MCP Logs

MCP サーバー：MCP ログの分析とデバッグ

🎯 概要

MCP Log Reader は、Model Context Protocol のログの分析とデバッグを支援する、専用の MCP サーバーです。ログファイルに直接アクセスできるため、MCP 連携のトラブルシューティングや、Claude がツールとどのようにやり取りするかの把握が簡単になります。

• マルチプラットフォーム対応：macOS、Windows、Linux で動作し、各プラットフォームに応じたログパスを使用します
• スマートフィルタリング：大文字と小文字を区別しないテキスト検索で、特定のログエントリを見つけます
• ページ分割表示：大量のログを効率よく閲覧できます
• サイズ管理：インテリジェントな切り詰め処理で、大きなログファイルを扱います
• シームレスな Claude 連携：Claude Desktop と直接連携します

🚀 クイックスタート

Smithery 経由でインストールする

Smithery 経由で、Claude Desktop 用の MCP Log Reader を自動的にインストールするには：

npx -y @smithery/cli install @klara-research/MCP-Analyzer --client claude

手動でインストールする

GitHub から直接インストールします：

# Clone the repository
git clone https://github.com/klara-research/MCP-Analyzer.git
cd MCP-Analyzer

# Install dependencies
npm i

ビルドして実行します：

# Compile TypeScript
npx tsc

🔌 Claude に接続する

Claude Desktop の設定にサーバーを追加します：

{
  "mcpServers": {
    "log-reader": {
      "command": "node",
      "args": [
        "/absolute/path/MCP-Analyzer/build"
      ]
    }
  }
}

その後、Claude Desktop を再起動します。

📋 使用可能なパラメーター

ログリーダーでは、次のパラメーターを使用できます：

パラメーター	説明	デフォルト
lines	各ログファイルから読み込む行数	100
filter	ログエントリのフィルタリングに使用するテキスト（大文字と小文字を区別しない）	""
customPath	ログディレクトリのカスタムパス	OS 固有
fileLimit	1 ページあたりに読み込むファイルの最大数	5
page	ページ分割表示でのページ番号	1

💡 使用例

Claude にログリーダーツールを使用するよう依頼します：

Can you check my MCP logs for any connection errors in the last day?

または、特定のパラメーターを指定します：

Can you look through MCP logs with filter="error" and lines=50 to find initialization issues?

⚙️ 仕組み

1. サーバーが OS を自動検出し、適切なログディレクトリを見つけます
2. すべての MCP ログファイルを見つけ、更新日時の新しい順に並べ替えます
3. ページ分割の設定に基づいて、指定されたページのログファイルを取得します
4. 応答が大きくなりすぎないようにサイズ制限を設けて、ファイルを処理します
5. フィルタリングされた内容を、ページ分割の詳細とともに構造化形式で返します

📄 ライセンス

MIT ライセンス