Amitdeshmukh Stdout MCP Server

🚀 stdout-mcp-server

stdout-mcp-server 是一個通過命名管道系統捕獲並管理標準輸出日誌的模型上下文協議（MCP）服務器。它可以捕捉多個進程或應用程序的日誌，使其在 Cursor IDE 中可供調試使用；還能即時監控應用程序輸出，並提供 MCP 接口來查詢、過濾和分析日誌。

🚀 快速開始

stdout-mcp-server 是一個強大的工具，用於捕獲和管理標準輸出日誌。以下將介紹其工作原理、系統要求、安裝選項和使用示例。

工作原理

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 或更高版本。

✨ 主要特性

• 命名管道創建和監控：自動創建並監控特定位置的命名管道，確保日誌的正常收集。
• 即時日誌捕獲和存儲：即時捕獲應用程序輸出的日誌，並進行存儲。
• 日誌過濾和檢索：通過 MCP 工具，可方便地對日誌進行過濾和檢索。
• 可配置的日誌歷史記錄：默認保留最近 100 條日誌記錄，可根據需求進行配置。
• 跨平臺支持：支持 Windows 和 Unix 系統。

📦 安裝指南

選項 1：在 Cursor 中安裝

1. 打開 Cursor，導航到 Cursor > 設置 > MCP 服務器。
2. 點擊“添加新的 MCP 服務器”。
3. 使用以下配置更新您的 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 時間戳，以毫秒為單位

📚 詳細文檔

命名管道位置

• 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 的許可。