stdout-mcp-server
@amitdeshmukh
An MCP server that any process can pipe stdout logs to including console logs from nodejs programs
Overview
What is stdout-mcp-server?
stdout-mcp-server is a Model Context Protocol (MCP) server that captures and manages stdout logs through a named pipe system. It is designed for developers using Cursor IDE or other MCP clients who need to collect logs from multiple processes, monitor application output in real time, and query/filter/analyze logs through an MCP interface.
How to use stdout-mcp-server?
Install it via npx stdout-mcp-server or configure it as an MCP server in your client (e.g., in Cursor under Settings > MCP Servers; or via JSON config with the command npx stdout-mcp-server). Once running, redirect application output to the named pipe (e.g., your_application > /tmp/stdout_pipe on Unix/MacOS) and use the get-logs MCP tool in your client to retrieve and filter logs.
Key features of stdout-mcp-server
- Creates and monitors a named pipe for log capture.
- Real-time log capture and storage.
- Log filtering and retrieval through the
get-logstool. - Configurable log history (default: 100 entries).
- Cross-platform support (Windows and Unix-based systems).
Use cases of stdout-mcp-server
- Capturing logs from multiple processes or applications in Cursor IDE.
- Monitoring application output in real time for debugging.
- Querying and filtering logs by content or timestamp.
- Consolidating stdout from several applications into one manageable stream.
FAQ from stdout-mcp-server
What are the system requirements for stdout-mcp-server?
Node.js v18 or newer is required.
How do I redirect application logs to the named pipe?
On Unix/MacOS, run your_application > /tmp/stdout_pipe. On Windows (PowerShell), use your_application > \\.\pipe\stdout_pipe.
What is the default log history size?
stdout-mcp-server maintains a history of the last 100 log entries by default.
Where is the named pipe located?
On Unix/MacOS it is at /tmp/stdout_pipe; on Windows it is \\.\pipe\stdout_pipe.
What MCP tools are provided?
The server provides one tool: get-logs, which accepts optional parameters lines (default 50), filter (text to filter by), and since (unix timestamp in milliseconds).
