Local Logs MCP Server

🚀 ローカルログMCPサーバー

モデルコンテキストプロトコル（MCP）サーバーで、リアルタイムのログ追跡、エラートラッキング、ログ検索機能を備えたローカルアプリケーションのログを監視できます。

Node.jsアプリケーション、Webサーバー、またはログファイルに書き込む任意のアプリケーションの監視に最適です。

✨ 主な機能

• 📁 ログファイルの自動検出 - 利用可能なログファイルを自動的に見つけて一覧表示します。
• 📜 リアルタイムログ追跡 - 任意のログファイルから最後のN行を取得します。
• ⚠️ エラー監視 - エラーログを迅速に確認して問題を特定します。
• 📊 サーバーステータス - ログ分析からサーバーのステータス概要を取得します。
• 👀 ログ監視 - ログファイルの変更を監視します。
• 🔍 ログ検索 - ログ内の特定のテキストパターンを検索します。
• 🔧 設定可能 - カスタムのログディレクトリとファイル拡張子をサポートします。
• 🚀 簡単なセットアップ - Cursor、Claude Desktop、VS Code Copilotなどと連携します。

🛠️ 利用可能なツール

📦 インストール

🚀 1コマンドセットアップ（推奨）

Linux/Mac:

curl -sSL https://raw.githubusercontent.com/mariosss/local-logs-mcp-server/main/install-new.js | node

Windows (PowerShell):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/mariosss/local-logs-mcp-server/main/install-new.js" | Invoke-Expression

以上で完了です！ インストールスクリプトがサーバーファイルを直接ダウンロードし、Cursorを自動的に設定します。Cursorを再起動するだけで使用可能です！

代替方法: 2コマンドセットアップ

npm install -g https://github.com/mariosss/local-logs-mcp-server
local-logs-setup

代替方法: 手動セットアップ

npm install -g local-logs-mcp-server
local-logs-setup

NPXを使用する場合（インストール不要）

npx local-logs-mcp-server

手動インストール

git clone https://github.com/mariosss/local-logs-mcp-server.git
cd local-logs-mcp-server
npm install -g .

⚙️ 設定

✅ 自動設定（デフォルト）

このパッケージは自動的にCursorを設定します！手動での設定は必要ありません。

🔧 手動設定（必要な場合）

Cursor IDE用

.cursor/mcp.json（プロジェクト固有）またはグローバルのMCP設定に追加します。

{
  "mcpServers": {
    "local-logs": {
      "command": "npx",
      "args": ["-y", "local-logs-mcp-server"],
      "env": {
        "LOGS_DIR": "./logs"
      }
    }
  }
}

Claude Desktop用

Claude DesktopのMCP設定（Macの場合は~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "local-logs": {
      "command": "npx",
      "args": ["-y", "local-logs-mcp-server"],
      "env": {
        "LOGS_DIR": "/path/to/your/logs"
      }
    }
  }
}

VS Code (GitHub Copilot)用

.vscode/mcp.jsonに追加します。

{
  "servers": {
    "local-logs": {
      "command": "npx",
      "args": ["-y", "local-logs-mcp-server"],
      "env": {
        "LOGS_DIR": "./logs"
      }
    }
  }
}

Windsurf (Codium)用

WindsurfのMCP設定に追加します。

{
  "mcpServers": {
    "local-logs": {
      "command": "npx",
      "args": ["-y", "local-logs-mcp-server"],
      "env": {
        "LOGS_DIR": "./logs"
      }
    }
  }
}

🔧 環境変数

ログディレクトリの自動検出

LOGS_DIRが指定されていない場合、サーバーは以下の優先順位でログを自動的に検索します。

1. ./logs（現在のディレクトリ）
2. ./apps/backend/logs（モノレポ構造）
3. ./server/logs（サーバーディレクトリ）
4. ./backend/logs（バックエンドディレクトリ）
5. /var/log（Linux/Macのシステムログ）
6. C:\logs（Windowsのシステムログ）

💻 使用例

基本的な使用法

MCPクライアントで設定した後、自然言語コマンドを使用できます。

• "サーバーのログを確認して"
• "ログにエラーはありますか？"
• "サーバーのステータスはどうですか？"
• "利用可能なログファイルを表示して"

高度な使用法

• "error.logの最後の50行を表示して"
• "ログから'database connection'を検索して"
• "access.logの変更を監視して"
• "TypeErrorを含むすべてのログエントリを見つけて"

🏗️ プロジェクト構造の例

標準的なNode.jsプロジェクト

your-project/
├── logs/
│   ├── combined.log    # メインアプリケーションログ
│   ├── error.log      # エラーログ
│   └── access.log     # アクセスログ（オプション）
├── .cursor/
│   └── mcp.json       # MCP設定
├── src/
└── package.json

モノレポ構造

your-monorepo/
├── apps/
│   └── backend/
│       └── logs/
│           ├── combined.log
│           └── error.log
├── .cursor/
│   └── mcp.json
└── package.json

🔍 サポートされるログ形式

このサーバーは、任意のテキストベースのログファイルで動作し、以下の形式を解析できます。

• Winstonログ（JSONおよびテキスト形式）
• Morganアクセスログ
• Pinoログ
• Bunyanログ
• カスタムアプリケーションログ
• システムログ
• 任意の.logまたは.txtファイル

ログ形式の例

Winstonテキスト形式:

2024-01-15 10:30:45 [INFO]: Server started on port 3000
2024-01-15 10:30:50 [ERROR]: Database connection failed

Winston JSON形式:

{"level":"info","message":"Server started","timestamp":"2024-01-15T10:30:45.123Z"}
{"level":"error","message":"Database connection failed","timestamp":"2024-01-15T10:30:50.456Z"}

🛡️ セキュリティ

• 読み取り専用アクセス - サーバーはログファイルを読み取るだけで、書き込みや変更は行いません。
• ディレクトリスコープ - 指定されたログディレクトリ内のファイルのみにアクセスします。
• ネットワークアクセスなし - 完全にローカルファイルで動作します。
• パーミッション尊重 - ファイルシステムのパーミッションを尊重します。

🚀 パフォーマンス

• 効率的なファイル読み取り - 大きなログファイルに対してストリーミングを使用します。
• メモリ節約 - ファイル全体をメモリにロードしません。
• 高速検索 - 最適化されたテキスト検索アルゴリズムを使用します。
• 最小限の依存関係 - Node.jsの組み込みモジュールのみを使用します。

🤝 コントリビュート方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）。
3. 変更をコミットします（git commit -m 'Add amazing feature'）。
4. ブランチにプッシュします（git push origin feature/amazing-feature）。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

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

サーバーが赤色/エラーステータスを表示する場合

• ログディレクトリが存在し、アクセス可能であることを確認します。
• ログファイルに適切な読み取り権限があることを確認します。
• Node.jsのバージョンが14以上であることを確認します。
• MCP設定でサーバーのパスが正しいことを確認します。

ツールが利用できない場合

• MCPクライアント（Cursor、Claude、VS Code）を再起動します。
• MCP設定の構文が有効なJSONであることを確認します。
• MCPサーバーが応答していることを確認します（echo '{"jsonrpc":"2.0","method":"initialize","id":1}' | npx local-logs-mcp-serverでテスト）。

ログファイルが見つからない場合

• 正しいLOGS_DIR環境変数を設定します。
• アプリケーションが実際にログファイルに書き込んでいることを確認します。
• ファイル拡張子がLOG_EXTENSIONS設定と一致することを確認します。
• ディレクトリの権限が読み取りを許可していることを確認します。

一般的なログディレクトリの問題

問題: "Logs directory not found"

# 解決策: 明示的なパスを設定する
export LOGS_DIR="/path/to/your/logs"

問題: "No log files found"

# 解決策: ファイル拡張子を確認する
export LOG_EXTENSIONS=".log,.txt,.out"

📚 セットアップの例

Cursorの完全セットアップ

1. グローバルにインストールする:

   npm install -g local-logs-mcp-server
   

2. .cursor/mcp.jsonに追加する:

   {
     "mcpServers": {
       "local-logs": {
         "command": "local-logs-mcp",
         "env": {
           "LOGS_DIR": "./logs"
         }
       }
     }
   }
   

3. Cursorを再起動してテストする:

   • 質問: "サーバーのログを確認して"

Claude Desktopの完全セットアップ

1. Claude Desktopの設定を開く:

   # Mac
   open ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # Windows
   notepad %APPDATA%\Claude\claude_desktop_config.json
   

2. 設定を追加する:

   {
     "mcpServers": {
       "local-logs": {
         "command": "npx",
         "args": ["-y", "local-logs-mcp-server"],
         "env": {
           "LOGS_DIR": "/Users/yourusername/projects/myapp/logs"
         }
       }
     }
   }
   

3. Claude Desktopを再起動する

🔗 関連プロジェクト

• Supabase MCP Server
• Model Context Protocol
• MCP Servers Collection
• Cursor IDE
• Claude Desktop

❤️ でMCPコミュニティのために作られました