stdout-mcp-server

一个模型上下文协议 (MCP) 服务器，通过命名管道系统捕获和管理 stdout 日志。此服务器特别适用于：

• 从多个进程或应用程序捕获日志，并使其可在 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 > 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

监控多个应用程序

您可以重定向来自多个来源的日志：

# 应用程序 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: "[2024-03-20T10:15:30.123Z] Application started\n[2024-03-20T10:15:31.456Z] Connected to database"
  }]
}

许可证

MIT 许可证