Skip to content

Latest commit

Β 

History

History
23 lines (14 loc) Β· 1.21 KB

File metadata and controls

23 lines (14 loc) Β· 1.21 KB

Known Bugs

MCP Servers

Community MCP servers writing to stdout breaks stdio protocol

Severity: High Affects: MCP test modal, MCP execution modal

Some community/marketplace MCP servers print human-readable messages (e.g. πŸš€ Hypertool MCP is ready!) to stdout on startup instead of reserving stdout exclusively for JSON-RPC messages. This violates the MCP stdio protocol specification.

Symptoms:

  • Test modal hangs or shows "process closed stdout unexpectedly"
  • MCP client receives non-JSON output and cannot parse the initialize response

Known affected servers:

  • @toolprint/hypertool-mcp β€” prints πŸš€ Hypertool MCP is ready! to stdout

Root cause: The MCP stdio transport requires that stdout is used only for JSON-RPC messages. Any other output (logging, greeting banners, debug info) must go to stderr. This is a bug in the MCP server implementations, not in this application.

Workaround: Use well-tested MCP servers that follow the protocol correctly, such as the official @modelcontextprotocol/server-everything reference server.

Potential improvement: Detect non-JSON output on stdout and surface a clearer error message to the user explaining the server is misbehaving.