feat(mcp): stdio demo subcommand + Glama Dockerfile (closes #593)

[kaiweijw]

Summary

• Adds nyxid mcp-demo — a stdio JSON-RPC subcommand exposing a curated, hardcoded tool surface (nyx_proxy_request, nyx_list_services, nyx_request_approval, nyx_exchange_identity). For directory-listing introspection (Glama). No DB, no auth, no shared state with the production /mcp HTTP transport.
• Adds kaiweijw to glama.json maintainers so the Glama listing can be claimed.
• Adds Dockerfile.glama (150 MB) that builds the binary and runs nyxid mcp-demo as ENTRYPOINT.

Why

Glama's scoring pipeline (per their bot comment on punkpeye/awesome-mcp-servers#5485) introspects a server's tools/list over stdio and grades it on tool-description quality (70%) + server coherence (30%). NyxID's production transport is OAuth-protected Streamable HTTP at /mcp with per-user dynamic tools — it can't be scored under that model. The demo subcommand is a parallel entry point built specifically to be introspectable by directory listings.

The 4 demo tools mirror NyxID's gateway positioning (proxy, discovery, approval, identity exchange) but are not wired to a backing service — tools/call returns a stub message pointing users at the real HTTP endpoint.

Verification

Local stdio:

$ printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' \
    | ./target/release/nyxid mcp-demo
{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"tools":{}},"serverInfo":{"name":"nyxid","version":"0.4.0"}}}
{"jsonrpc":"2.0","id":2,"result":{"tools":[...4 tools...]}}

Docker:

$ docker build -f Dockerfile.glama -t nyxid-glama:demo .   # 150 MB
$ printf '...' | docker run --rm -i nyxid-glama:demo
initialize ok: nyxid v0.4.0
tools/list returned 4 tools: nyx_proxy_request, nyx_list_services, nyx_request_approval, nyx_exchange_identity

Stderr stays clean (tracing/dotenv are skipped in mcp-demo mode so JSON-RPC stream isn't corrupted).

Follow-up after merge

1. Claim the Glama listing at https://glama.ai/mcp/servers/ChronoAIProject/NyxID (now possible since kaiweijw is on the maintainers list).
2. Paste Dockerfile.glama content into Glama's admin Dockerfile page (Glama doesn't auto-read it from the repo).
3. Trigger re-evaluation; verify tools/list introspection lands a score.
4. Update punkpeye/awesome-mcp-servers#5485 entry to inline the badge in the README diff per @punkpeye's format.

Test plan

• CI: cargo build, cargo test, cargo clippy, cargo fmt --check (pre-commit hooks already passed locally)
• CI: frontend type-check + lint unchanged (no frontend changes in this PR)
• Manual: nyxid mcp-demo responds to initialize, tools/list, ping, and unknown methods (-32601)
• Manual: docker build -f Dockerfile.glama . succeeds and the resulting image speaks stdio MCP
• After merge: listing claim succeeds on Glama, score badge renders