stdout-mcp-server

stdout-mcp-server

名前付きパイプシステムを通じて stdout ログを取得・管理する Model Context Protocol（MCP）サーバーです。このサーバーは、特に次の用途に役立ちます。

• 複数のプロセスやアプリケーションからログを取得し、Cursor IDE でのデバッグに利用できるようにします。
• アプリケーションの出力をリアルタイムで監視し、ログの検索、フィルタリング、分析を行うための MCP インターフェースを提供します。

仕組み

1. サーバーは特定の場所に名前付きパイプを作成します（Unix/MacOS では /tmp/stdout_pipe、Windows では \\.\pipe\stdout_pipe）。

2. 任意のアプリケーションが標準出力のリダイレクトを使用して、このパイプにログを書き込めます。例：

your_application | tee /tmp/stdout_pipe # or
your_application > /tmp/stdout_pipe

3. サーバーはパイプを監視し、受信したすべてのログを取得して、直近の 100 件を履歴として保持します。

4. MCP ツールを通じて、これらのログを検索、フィルタリング、分析できます。

システム要件

インストールする前に、次の要件を満たしていることを確認してください。

• Node.js v18 以降

インストール方法

方法 1：Cursor にインストール

1. Cursor を開き、Cursor > Settings > MCP Servers に移動します。
2. 「Add new MCP Server」をクリックします。
3. 次の設定で MCP 設定ファイルを更新します。

name: stdout-mcp-server
type: command
command: npx stdout-mcp-server

方法 2：その他の MCP クライアントにインストール

その他の MCP クライアントへのインストール

macOS/Linux の場合：

{
  "mcpServers": {
    "stdio-mcp-server": {
      "command": "npx",
      "args": [
        "stdio-mcp-server"
      ]
    }
  }
}

Windows の場合：

{
  "mcpServers": {
    "mcp-installer": {
      "command": "cmd.exe",
      "args": ["/c", "npx", "stdio-mcp-server"]
    }
  }
}

使用例

アプリケーションログのリダイレクト

アプリケーションの出力をパイプに送信するには、次のようにします。

# Unix/MacOS
your_application > /tmp/stdout_pipe

# Windows (PowerShell)
your_application > \\.\pipe\stdout_pipe

複数のアプリケーションの監視

複数のソースからログをリダイレクトできます。

# Application 1
app1 > /tmp/stdout_pipe &

# Application 2
app2 > /tmp/stdout_pipe &

ログの検索

AI は MCP クライアントで get-logs ツールを使用して、ログを取得、フィルタリングします。

// Get last 50 logs
get-logs()

// Get last 100 logs containing "error"
get-logs({ lines: 100, filter: "error" })

// Get logs since a specific timestamp
get-logs({ since: 1648675200000 }) // Unix timestamp in milliseconds

機能

• 名前付きパイプの作成と監視
• リアルタイムでのログ取得と保存
• MCP ツールによるログのフィルタリングと取得
• 設定可能なログ履歴（デフォルト：100 件）
• クロスプラットフォーム対応（Windows および Unix 系システム）

名前付きパイプの場所

• Windows：\\.\pipe\stdout_pipe
• Unix/MacOS：/tmp/stdout_pipe

利用可能なツール

get-logs

オプションのフィルタリングを指定して、名前付きパイプからログを取得します。

パラメーター：

• lines（任意、デフォルト：50）：返すログ行数
• filter（任意）：ログを絞り込むためのテキスト
• since（任意）：この時刻以降のログを取得するためのタイムスタンプ

応答例：

// Response format
{
  content: [{
    type: "text",
    text: "[2024-03-20T10:15:30.123Z] Application started\n[2024-03-20T10:15:31.456Z] Connected to database"
  }]
}

ライセンス

MIT License