stdout-mcp-server

by amitdeshmukh

Integrations

  • Provides support for capturing stdout logs from applications running on Unix/Linux systems through a named pipe at /tmp/stdout_pipe.

  • Enables monitoring of application output on macOS systems through a named pipe at /tmp/stdout_pipe, allowing real-time log capture and analysis.

  • Serves as a runtime requirement for the server with Node.js v18 or newer needed to run the MCP server.

stdout-mcp-server

A Model Context Protocol (MCP) server that captures and manages stdout logs through a named pipe system. This server is particularly useful for:

  • Capturing logs from multiple processes or applications and making them available for debugging in Cursor IDE.
  • Monitoring application output in real-time and providing a MCP interface to query, filter, and analyze logs

How It Works

  1. The server creates a named pipe at a specific location (/tmp/stdout_pipe on Unix/MacOS or \\.\pipe\stdout_pipe on Windows)
  2. Any application can write logs to this pipe using standard output redirection. For example:
your_application | tee /tmp/stdout_pipe # or your_application > /tmp/stdout_pipe
  1. The server monitors the pipe, captures all incoming logs, and maintains a history of the last 100 entries
  2. Through MCP tools, you can query, filter, and analyze these logs

System Requirements

Before installing, please ensure you have:

  • Node.js v18 or newer

Installation Options

Option 1: Installation in Cursor

  1. Open Cursor and navigate to Cursor > Settings > MCP Servers
  2. Click on "Add new MCP Server"
  3. Update your MCP settings file with the following configuration:
name: stdout-mcp-server type: command command: npx stdout-mcp-server

Option 2: Installation in other MCP clients

Installation in other MCP clients

For macOS/Linux:

{ "mcpServers": { "stdio-mcp-server": { "command": "npx", "args": [ "stdio-mcp-server" ] } } }

For Windows:

{ "mcpServers": { "mcp-installer": { "command": "cmd.exe", "args": ["/c", "npx", "stdio-mcp-server"] } } }

Usage Examples

Redirecting Application Logs

To send your application's output to the pipe:

# Unix/MacOS your_application > /tmp/stdout_pipe # Windows (PowerShell) your_application > \\.\pipe\stdout_pipe

Monitoring Multiple Applications

You can redirect logs from multiple sources:

# Application 1 app1 > /tmp/stdout_pipe & # Application 2 app2 > /tmp/stdout_pipe &

Querying Logs

Your AI will use the get-logs tool in your MCP client to retrieve and filter 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

Features

  • Named pipe creation and monitoring
  • Real-time log capture and storage
  • Log filtering and retrieval through MCP tools
  • Configurable log history (default: 100 entries)
  • Cross-platform support (Windows and Unix-based systems)

Named Pipe Locations

  • Windows: \\.\pipe\stdout_pipe
  • Unix/MacOS: /tmp/stdout_pipe

Available Tools

get-logs

Retrieve logs from the named pipe with optional filtering:

Parameters:

  • lines (optional, default: 50): Number of log lines to return
  • filter (optional): Text to filter logs by
  • since (optional): Timestamp to get logs after

Example responses:

// Response format { content: [{ type: "text", text: "[2024-03-20T10:15:30.123Z] Application started\n[2024-03-20T10:15:31.456Z] Connected to database" }] }

License

MIT License

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that captures and manages stdout logs through named pipes, making application output available for querying and debugging in AI tools like Cursor IDE.

  1. How It Works
    1. System Requirements
      1. Installation Options
        1. Option 1: Installation in Cursor
        2. Option 2: Installation in other MCP clients
      2. Installation in other MCP clients
        1. Usage Examples
          1. Redirecting Application Logs
          2. Monitoring Multiple Applications
          3. Querying Logs
        2. Features
          1. Named Pipe Locations
            1. Available Tools
              1. get-logs
            2. License

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.
                Last updated -
                10
                Python
                • Apple
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that provides programmatic access to the Windows terminal, enabling AI models to interact with the Windows command line through standardized tools for writing commands, reading output, and sending control signals.
                Last updated -
                3
                JavaScript
                MIT License
              • A
                security
                F
                license
                A
                quality
                A starter template for building Model Context Protocol servers that can be integrated with Cursor or Claude Desktop, allowing developers to create custom tools and extensions for AI assistants.
                Last updated -
                1
                6
                9
                TypeScript
                • Apple
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.
                Last updated -
                19
                TypeScript
                • Apple

              View all related MCP servers

              ID: evmwj4zgd3