dev-mcp-mock

Overview ¶

dev-mcp-mock is a development-only fixture that dev/start.sh launches alongside the platform so operators can exercise the MCP gateway feature end-to-end without setting up a real upstream. Two services run from a single process:

• :9180 Mock OAuth 2.1 provider with authorization_code+PKCE, refresh_token, and client_credentials grants. Access tokens default to a 1-hour TTL (override with ACCESS_TTL_SECONDS=10 to exercise refresh quickly).
• :9181 Mock MCP server (streamable HTTP) with three trivial tools: echo, add, now. Bearer-permissive by default; set STRICT_AUTH=1 to validate that the bearer token was issued by the OAuth server above.

dev/seed.sql pre-creates an mcp connection named "dev-mock" pointing at this server, so opening the admin portal immediately shows dev-mock__echo / dev-mock__add / dev-mock__now in the platform's tools/list.

Usage:

go run ./cmd/dev-mcp-mock
STRICT_AUTH=1 go run ./cmd/dev-mcp-mock
ACCESS_TTL_SECONDS=10 go run ./cmd/dev-mcp-mock

Health:

curl http://localhost:9180/.health
curl http://localhost:9181/.health