MCP Server Logger

@mlshv

About MCP Server Logger

console.log for your stdio MCP server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcps-logger": {
      "command": "npx",
      "args": [
        "mcps-logger"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP Server Logger?

MCP Server Logger provides a way to use console.log and other console methods in an MCP server using stdio transport without breaking protocol communication. It patches console.log, warn, error, and debug to redirect their output to a separate terminal. This project is for developers building or debugging MCP servers with stdio transport.

How to use MCP Server Logger?

First run npx mcps-logger in a terminal where you want to see logs. Then install the package (npm install mcps-logger) and add import "mcps-logger/console" to your MCP server’s entry file. For development‑only usage, wrap the import in a NODE_ENV !== "production" condition.

Key features of MCP Server Logger

Patches console.log, warn, error, and debug
Redirects logs to a separate terminal
Prevents JSON parse errors in MCP Inspector
Simple one-line import to activate
Supports conditional use in development mode

Use cases of MCP Server Logger

Debugging MCP servers while they communicate via stdio
Separating log output from the protocol message stream
Avoiding SyntaxError from stray console.log calls in MCP Inspector
Using familiar console methods without breaking MCP transport

FAQ from MCP Server Logger

What problem does MCP Server Logger solve?

When stdio transport is used, console.log calls produce text that the MCP client cannot parse as JSON, causing SyntaxError in tools like MCP Inspector. The logger redirects console messages to a separate terminal, preserving protocol integrity.

How do I install and use MCP Server Logger?

Install via npm (npm install mcps-logger), then import "mcps-logger/console" in your server’s entry file. Before starting the server, run npx mcps-logger in a separate terminal to see the redirected logs.

Can I use MCP Server Logger in production?

The README suggests using it only in development mode (e.g., if (process.env.NODE_ENV !== "production")). It is designed as a debugging aid, not a production logging solution.

What console methods does it patch?

It patches log, warn, error, and debug.

Do I need to modify existing console.log calls to use it?

No. The import automatically patches all console methods so existing calls are redirected without source code changes.

Frequently asked questions

What problem does MCP Server Logger solve?

How do I install and use MCP Server Logger?

Install via npm (`npm install mcps-logger`), then import `"mcps-logger/console"` in your server’s entry file. Before starting the server, run `npx mcps-logger` in a separate terminal to see the redirected logs.

Can I use MCP Server Logger in production?

The README suggests using it only in development mode (e.g., `if (process.env.NODE_ENV !== "production")`). It is designed as a debugging aid, not a production logging solution.