local-stdio-server

Overview ¶

Mock MCP Server for testing local process (stdio) MCP server support. This server communicates via stdin/stdout using JSON-RPC.

Build:

go build -o mock-stdio-server .

The server reads JSON-RPC requests from stdin (one per line) and writes JSON-RPC responses to stdout. Each request/response is a single line of JSON.

Supports (legacy handshake mode, the default):

• initialize - MCP handshake
• notifications/initialized - Notification acknowledgment
• tools/list - Returns sample tools
• tools/call - Execute tools (echo, add, get_time)
• ping - Health check

With -protocol 2026-07-28 the server speaks the stateless generation instead: server/discover replaces the handshake and ping, results carry resultType and cache metadata, and the removed legacy methods answer -32601 (mirroring mock-mcp-server's -protocol flag).