stdout-mcp-server

🚀 stdout-mcp-server 中文版

这是一个借助命名管道系统来捕获和管理标准输出日志的模型上下文协议（MCP）服务器。它具备以下实用价值：

• 能够捕获多个进程或应用程序的日志，方便在 Cursor IDE 中进行调试。
• 可实时监控应用程序输出，还能通过 MCP 接口对日志进行查询、过滤和分析。

🚀 快速开始

系统要求

安装前，请确保满足以下条件：

• Node.js v18 或更高版本

安装选项

选项 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"]
    }
  }
}

✨ 主要特性

• 实时日志捕获
• 历史日志记录
• 日志过滤和查询
• 支持多源日志输入

📦 安装指南

选项 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 时间戳

📚 详细文档

工作原理

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 app.js
这是一个示例应用程序。

日志查询结果

// 获取所有日志
[
  {
    "timestamp": "2023-10-26T12:34:56.789Z",
    "level": "info",
    "message": "这是一个示例应用程序。"
  }
]

🔧 技术细节

日志捕获与管理

服务器在特定位置创建命名管道，应用程序通过标准输出重定向将日志写入该管道。服务器监控管道，捕获所有传入的日志，并维护最近 100 条记录的历史。

日志查询与分析

通过 MCP 工具，用户可以对捕获的日志进行查询、过滤和分析。

📄 许可证

文档未提及相关许可证信息。

⚠️ 重要提示

• 确保 Node.js 已正确安装并配置环境变量。
• 在 Windows 系统上，可能需要管理员权限来创建命名管道。
• 如有任何问题，请检查管道权限和相关日志输出。

通过以上说明，您可以轻松地将应用程序的日志集成到 MCP 服务器中，并利用其强大的日志管理功能进行开发和调试。