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 的许可。