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 # 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 许可证