_mock-servers/

🧪 Mock Servers

Test MCP servers for development purposes.

🚀 Quick Start

Build and run all mock servers with a single command:

task mock:servers

This builds both servers and starts mock-mcp-server on ports 9001 (HTTP) and 9002 (SSE).

To use custom ports:

task mock:servers PORT=3000

This starts HTTP on port 3000 and SSE on port 3001.

To stop and clean up:

task mock:clean

📂 Servers

🖥️ local-stdio-server

A Go-based MCP server that communicates via stdio (stdin/stdout JSON-RPC).

Build

cd examples/_mock-servers/local-stdio-server
go build -o mock-stdio-server .

Usage

Used by examples/transports/local-mcp.yaml.

By default the server speaks the legacy handshake generation (initialize, ping). Pass -protocol 2026-07-28 to speak the stateless generation instead: server/discover replaces the handshake and ping, results carry resultType and cache metadata, and the removed legacy methods answer -32601.

🌐 mock-mcp-server

A Go-based MCP server that supports HTTP and SSE transports.

Run

cd examples/_mock-servers/mock-mcp-server

# HTTP mode (defaults to port 8080 when -port is omitted)
go run main.go -port 9001

# SSE mode
go run main.go -port 9002 -sse

# Stateless generation (2026-07-28: server/discover, no handshake)
go run main.go -port 9001 -protocol 2026-07-28

OAuth Flags

The server can simulate an OAuth 2.1 protected resource for exercising auth.type: oauth brokering:

Usage

Used by examples/transports/external-mcp.yaml.