stdout-mcp-server

stdout-mcp-server

site icon
2025.04.09 0
TypeScript日志管理调试工具开发效率
stdout-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务器,专门用于捕获和管理通过命名管道系统的标准输出日志。该服务器特别适用于多进程或应用程序的日志捕获,使得在 Cursor IDE 中进行调试更加便捷。同时,它还支持实时监控应用程序输出,并通过 MCP 接口提供查询、过滤和分析日志的功能。
View on GitHub

Overview

基本能力

产品定位

stdout-mcp-server 是一个日志捕获和管理工具,旨在通过 MCP 协议提供日志的实时监控、查询和分析功能。

核心功能

  • 命名管道的创建和监控
  • 实时日志捕获和存储
  • 通过 MCP 工具进行日志过滤和检索
  • 可配置的日志历史记录(默认 100 条)
  • 跨平台支持(Windows 和 Unix 系统)

适用场景

  • 多进程或应用程序的日志捕获和调试
  • 实时监控应用程序输出
  • 日志的查询、过滤和分析

工具列表

  • get-logs: 从命名管道中检索日志,支持按行数、过滤文本和时间戳进行筛选。

常见问题解答

  • 命名管道位置:
  • Windows: \\.\pipe\stdout_pipe
  • Unix/MacOS: /tmp/stdout_pipe

使用教程

使用依赖

  • Node.js v18 或更新版本

安装教程

在 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

在其他 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 &

查询日志

// 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

许可证

该项目遵循 MIT 开源许可条款。