Amitdeshmukh Stdout MCP Server

🚀 stdout-mcp-server

このモデルコンテキストプロトコル（MCP）サーバーは、名前付きパイプシステムを通じて標準出力ログをキャプチャし管理します。このサーバーは以下の用途に特に適しています。

• 複数のプロセスやアプリケーションのログをキャプチャし、Cursor IDE でデバッグできるようにします。
• アプリケーションの出力をリアルタイムで監視し、MCP インターフェースを通じてログのクエリ、フィルタリング、分析を行います。

🚀 クイックスタート

仕組み

1. サーバーは特定の場所に名前付きパイプを作成します（Unix/MacOS システムでは /tmp/stdout_pipe、Windows システムでは \\.\pipe\stdout_pipe）。
2. 任意のアプリケーションは、標準出力のリダイレクトを通じてこのパイプにログを書き込むことができます。例えば：

your_application | tee /tmp/stdout_pipe # または
your_application > /tmp/stdout_pipe

3. サーバーはこのパイプを監視し、すべての入力ログをキャプチャし、最近の 100 件の記録の履歴を維持します。
4. MCP ツールを通じて、これらのログをクエリ、フィルタリング、分析することができます。

システム要件

インストール前に、以下がインストールされていることを確認してください。

• Node.js v18 以上

📦 インストール

オプション 1：Cursor でのインストール

1. Cursor を開き、Cursor > 設定 > MCP サーバー に移動します。 2.「新しい MCP サーバーを追加」をクリックします。
2. 以下の設定で MCP 設定ファイルを更新します。

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

オプション 2：他の 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

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

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

# アプリケーション 1
app1 > /tmp/stdout_pipe &

# アプリケーション 2
app2 > /tmp/stdout_pipe &

ログのクエリ

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

// 最後の 50 件のログを取得
get-logs()

// "error" を含む最後の 100 件のログを取得
get-logs({ lines: 100, filter: "error" })

// 特定のタイムスタンプ以降のログを取得
get-logs({ since: 1648675200000 }) // Unix タイムスタンプ（ミリ秒）

✨ 主な機能

• 名前付きパイプの作成と監視
• リアルタイムのログキャプチャと保存
• MCP ツールを通じたログのフィルタリングと検索
• 設定可能なログ履歴（デフォルト：100 件）
• クロスプラットフォーム対応（Windows と Unix システム）

名前付きパイプの位置

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

利用可能なツール

get-logs

名前付きパイプからログを取得し、オプションでフィルタリングします。 パラメータ：

• lines（オプション、デフォルト：50）：返されるログの行数
• filter（オプション）：ログをフィルタリングするためのテキスト
• since（オプション）：特定のタイムスタンプ以降のログを取得

応答例：

// 応答形式
{
  content: [{
    type: "text",
    text: "[2023-10-05 12:34:56] 情報：システム起動"
  }]
}

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。