# labs-catalog-mcp

**A real MCP server, with a real captured session.** LB-07 in the [AI Labs portfolio](https://ai-labs.sudeeplalka.com)'s
Live Builds collection: the portfolio's MCP Server Contract Workbench (GAP-01) *simulates* the wire protocol to teach
it — this repo is the live counterpart a real client can connect to.

The server exposes the portfolio's own labs registry as tools:

| tool | what it does |
|------|--------------|
| `list_labs` | list labs, filter by collection (0–5) or badge (LIVE/SIMULATED) |
| `get_lab` | one lab's problem, decision, status, route |
| `search_decisions` | find the lab for the enterprise decision you're facing |

## Run it

```bash
npm install
npm start            # stdio MCP server
npm run capture      # real client session -> session-transcript.jsonl + console output
```

## Connect Claude Desktop

```json
{
  "mcpServers": {
    "labs-catalog": { "command": "node", "args": ["/absolute/path/to/server.mjs"] }
  }
}
```

## The captured session

`session-transcript.jsonl` / `session.md` hold an actual recorded session — initialize handshake, `tools/list`,
and three tool calls, both directions, timestamped. Recorded by `tee-wire.mjs`, a 30-line wire tap between
client and server; re-run `npm run capture` and it regenerates. No frame in this repo is hand-written.

## Honesty & attribution

Built on [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) (MIT) and zod.
Catalog data is a generated snapshot of the portfolio's `packages/kit/src/registry.ts`. Server, wire tap, and
capture harness are original. MIT licensed.