{"_id":"@ai-spec-room/mcp-adapter","_rev":"4-ce14a79a2287b891c3b282c4af57c9fc","name":"@ai-spec-room/mcp-adapter","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@ai-spec-room/mcp-adapter","version":"0.1.0","keywords":["mcp","ai","spec","collaboration","claude","cursor","codex"],"license":"UNLICENSED","_id":"@ai-spec-room/mcp-adapter@0.1.0","maintainers":[{"name":"caleb123","email":"liushenpeng1@outlook.com"}],"homepage":"https://github.com/liushenpeng1-cmyk/ai-spec-room#readme","bugs":{"url":"https://github.com/liushenpeng1-cmyk/ai-spec-room/issues"},"bin":{"ai-spec-room-mcp":"dist/index.js"},"dist":{"shasum":"bcd4b612f2ab6932ca9781ff15d72f5089333c60","tarball":"https://registry.npmjs.org/@ai-spec-room/mcp-adapter/-/mcp-adapter-0.1.0.tgz","fileCount":6,"integrity":"sha512-zpdrlPuXXj1mNILybQtzaKcXIDiTZ51vCGWf2RphsswLt6JZTBnncf7AXLQAwB52DSYPNrMliwie2PPv7woY5w==","signatures":[{"sig":"MEQCIECtAhzhRvt95UCRjmWDnCXaAxkFLZarntq9YDnK9El5AiBn3lGRkDQftqHEl5wpSdUM1AUlE+M3VgKhSZg5J7Lk+Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51147},"main":"dist/index.js","type":"module","_from":"file:ai-spec-room-mcp-adapter-0.1.0.tgz","scripts":{"build":"tsc -p tsconfig.json","start":"node dist/index.js"},"_npmUser":{"name":"caleb123","email":"liushenpeng1@outlook.com"},"_resolved":"/private/var/folders/bj/sbzcbtzj7mx1jjpdnl5lb7d00000gn/T/423ca9b588af30450d109991d208c768/ai-spec-room-mcp-adapter-0.1.0.tgz","_integrity":"sha512-zpdrlPuXXj1mNILybQtzaKcXIDiTZ51vCGWf2RphsswLt6JZTBnncf7AXLQAwB52DSYPNrMliwie2PPv7woY5w==","repository":{"url":"git+https://github.com/liushenpeng1-cmyk/ai-spec-room.git","type":"git","directory":"adapters/mcp"},"_npmVersion":"11.7.0","description":"MCP adapter — wires an MCP-capable AI runtime (Claude Code, Cursor, Codex) to the provider-neutral AI Spec Room core API.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.24.1","@ai-spec-room/core-sdk":"^0.1.0","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-adapter_0.1.0_1776783611700_0.3307343871359387","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ai-spec-room/mcp-adapter","version":"0.1.1","keywords":["mcp","ai","spec","collaboration","claude","cursor","codex"],"license":"MIT","_id":"@ai-spec-room/mcp-adapter@0.1.1","maintainers":[{"name":"caleb123","email":"liushenpeng1@outlook.com"}],"homepage":"https://github.com/liushenpeng1-cmyk/ai-spec-room#readme","bugs":{"url":"https://github.com/liushenpeng1-cmyk/ai-spec-room/issues"},"bin":{"ai-spec-room-mcp":"dist/index.js"},"dist":{"shasum":"f4ac6d575a3627f10f1b1dc5787f565af2947642","tarball":"https://registry.npmjs.org/@ai-spec-room/mcp-adapter/-/mcp-adapter-0.1.1.tgz","fileCount":7,"integrity":"sha512-WMgfSQRqoJXlEr5ZxxHlcUh2Li25xkTV2/WHeFQpjG52jxQZ5bdjIhSN9vIHx0HAxyIW70WIE2wrwrKRuepCEw==","signatures":[{"sig":"MEQCICHs+K0q2BEYQa1Bpo1268VGiC9tNVJm6x9KoHhFOghKAiALql5BIz4g1wVQZMlSQYhNnb40FoGcnNlHVGvgzMBwRA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52221},"main":"dist/index.js","type":"module","_from":"file:ai-spec-room-mcp-adapter-0.1.1.tgz","scripts":{"build":"tsc -p tsconfig.json","start":"node dist/index.js"},"_npmUser":{"name":"caleb123","email":"liushenpeng1@outlook.com"},"_resolved":"/private/var/folders/bj/sbzcbtzj7mx1jjpdnl5lb7d00000gn/T/98f783f37129fcae179cc1f7b9741188/ai-spec-room-mcp-adapter-0.1.1.tgz","_integrity":"sha512-WMgfSQRqoJXlEr5ZxxHlcUh2Li25xkTV2/WHeFQpjG52jxQZ5bdjIhSN9vIHx0HAxyIW70WIE2wrwrKRuepCEw==","repository":{"url":"git+https://github.com/liushenpeng1-cmyk/ai-spec-room.git","type":"git","directory":"adapters/mcp"},"_npmVersion":"11.7.0","description":"MCP adapter — wires an MCP-capable AI runtime (Claude Code, Cursor, Codex) to the provider-neutral AI Spec Room core API.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.24.1","@ai-spec-room/core-sdk":"^0.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-adapter_0.1.1_1776783872408_0.4957345357207128","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ai-spec-room/mcp-adapter","version":"0.1.2","keywords":["mcp","ai","spec","collaboration","claude","cursor","codex"],"license":"MIT","_id":"@ai-spec-room/mcp-adapter@0.1.2","maintainers":[{"name":"caleb123","email":"liushenpeng1@outlook.com"}],"homepage":"https://github.com/liushenpeng1-cmyk/ai-spec-room#readme","bugs":{"url":"https://github.com/liushenpeng1-cmyk/ai-spec-room/issues"},"bin":{"ai-spec-room-mcp":"dist/index.js"},"dist":{"shasum":"244cce867daf9815c4e95e60bb19f2357a1c9cbe","tarball":"https://registry.npmjs.org/@ai-spec-room/mcp-adapter/-/mcp-adapter-0.1.2.tgz","fileCount":7,"integrity":"sha512-eNMnXnJrf8g5/d8h2goq+CiFtq9wVl611UsMPhxGk1d0qLcWLJurklzQV9haxRH5F78lx4h7xiyRDBtyvD5yYA==","signatures":[{"sig":"MEYCIQCrnQo7s+RPhVET3C6BSakAJ4G6Z04l8bxUvAXuUjtW5wIhAJ0+jKNkQ4BPHxcmU7jm9xjQF9WdfGFxPdzSR9sLK1fb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53967},"main":"dist/index.js","type":"module","_from":"file:ai-spec-room-mcp-adapter-0.1.2.tgz","scripts":{"build":"tsc -p tsconfig.json","start":"node dist/index.js"},"_npmUser":{"name":"caleb123","email":"liushenpeng1@outlook.com"},"_resolved":"/private/var/folders/bj/sbzcbtzj7mx1jjpdnl5lb7d00000gn/T/b81af957681dc7129e190ae2d66fbd88/ai-spec-room-mcp-adapter-0.1.2.tgz","_integrity":"sha512-eNMnXnJrf8g5/d8h2goq+CiFtq9wVl611UsMPhxGk1d0qLcWLJurklzQV9haxRH5F78lx4h7xiyRDBtyvD5yYA==","repository":{"url":"git+https://github.com/liushenpeng1-cmyk/ai-spec-room.git","type":"git","directory":"adapters/mcp"},"_npmVersion":"11.7.0","description":"MCP adapter — wires an MCP-capable AI runtime (Claude Code, Cursor, Codex) to the provider-neutral AI Spec Room core API.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"zod":"^3.24.1","@ai-spec-room/core-sdk":"^0.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.10.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-adapter_0.1.2_1776794450469_0.004485637746261872","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ai-spec-room/mcp-adapter","version":"0.1.3","description":"MCP adapter — wires an MCP-capable AI runtime (Claude Code, Cursor, Codex) to the provider-neutral AI Spec Room core API.","type":"module","main":"dist/index.js","bin":{"ai-spec-room-mcp":"dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.24.1","@ai-spec-room/core-sdk":"^0.1.1"},"devDependencies":{"@types/node":"^22.10.1","typescript":"^5.6.3"},"publishConfig":{"access":"public"},"keywords":["mcp","ai","spec","collaboration","claude","cursor","codex"],"repository":{"type":"git","url":"git+https://github.com/liushenpeng1-cmyk/ai-spec-room.git","directory":"adapters/mcp"},"license":"MIT","scripts":{"build":"tsc -p tsconfig.json","start":"node dist/index.js"},"_id":"@ai-spec-room/mcp-adapter@0.1.3","bugs":{"url":"https://github.com/liushenpeng1-cmyk/ai-spec-room/issues"},"homepage":"https://github.com/liushenpeng1-cmyk/ai-spec-room#readme","_integrity":"sha512-KutqfPDWNuQQuuWHOSMt2r+Yb9oLewwz3yCWyKP8jOWMYXKWnAE3ewsbkNkBo9TPzLpmqnbgH5XCbL/Y/aVgbw==","_resolved":"/private/var/folders/bj/sbzcbtzj7mx1jjpdnl5lb7d00000gn/T/cdce1ce0d9d842bed4d3f920fe34eae8/ai-spec-room-mcp-adapter-0.1.3.tgz","_from":"file:ai-spec-room-mcp-adapter-0.1.3.tgz","_nodeVersion":"25.3.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-KutqfPDWNuQQuuWHOSMt2r+Yb9oLewwz3yCWyKP8jOWMYXKWnAE3ewsbkNkBo9TPzLpmqnbgH5XCbL/Y/aVgbw==","shasum":"090c6ae95d0f3d2fbe8e1eceb0b1285a7f446b95","tarball":"https://registry.npmjs.org/@ai-spec-room/mcp-adapter/-/mcp-adapter-0.1.3.tgz","fileCount":7,"unpackedSize":57393,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCKppSMP1KJogK8OGlArEZO+fpjOF51PPub08YnFk314wIgXPWHI2dLQYOQTwPIz0bXCYkDnianDjcbQKhylkLmul8="}]},"_npmUser":{"name":"caleb123","email":"liushenpeng1@outlook.com"},"directories":{},"maintainers":[{"name":"caleb123","email":"liushenpeng1@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-adapter_0.1.3_1776974136399_0.1494370377785723"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-21T15:00:11.604Z","modified":"2026-04-23T19:55:36.644Z","0.1.0":"2026-04-21T15:00:11.841Z","0.1.1":"2026-04-21T15:04:32.545Z","0.1.2":"2026-04-21T18:00:50.613Z","0.1.3":"2026-04-23T19:55:36.535Z"},"bugs":{"url":"https://github.com/liushenpeng1-cmyk/ai-spec-room/issues"},"license":"MIT","homepage":"https://github.com/liushenpeng1-cmyk/ai-spec-room#readme","keywords":["mcp","ai","spec","collaboration","claude","cursor","codex"],"repository":{"type":"git","url":"git+https://github.com/liushenpeng1-cmyk/ai-spec-room.git","directory":"adapters/mcp"},"description":"MCP adapter — wires an MCP-capable AI runtime (Claude Code, Cursor, Codex) to the provider-neutral AI Spec Room core API.","maintainers":[{"name":"caleb123","email":"liushenpeng1@outlook.com"}],"readme":"# @ai-spec-room/mcp-adapter\n\nMCP adapter that connects any MCP-capable AI runtime (Claude Code, Cursor, Codex) to an [AI Spec Room](https://ai-spec-room.vercel.app).\n\n## Quick start\n\n`cd` into the folder whose notes you want this session to see, then:\n\n```bash\n# per room: create .mcp.json from the web UI's curl one-liner\ncurl -fsSL \"https://ai-spec-room.vercel.app/api/rooms/<ROOM_ID>/mcp?token=<TOKEN>\" > .mcp.json\n\n# then open your runtime of choice\nclaude   # or cursor, or codex\n```\n\nThe `.mcp.json` tells the runtime to launch this adapter via `npx -y @ai-spec-room/mcp-adapter` on demand — no global install required. The adapter treats its current working directory as the private-memory root, so **the folder you ran the command in is the folder the AI can search**. No path configuration needed.\n\n## Private memory scope\n\nThe `search_my_context` MCP tool reads markdown files recursively under the adapter's context root. That root is resolved in this order:\n\n1. `MY_CONTEXT_DIR` env var — per-room explicit override\n2. `ASR_MY_CONTEXT_DIR` env var — shell-level default (e.g. exported in `~/.zshrc`)\n3. `process.cwd()` — fallback, the directory where the runtime launched the adapter\n\nIf you want to pin the notes folder regardless of cwd, set `ASR_MY_CONTEXT_DIR` once:\n\n```bash\necho 'export ASR_MY_CONTEXT_DIR=~/notes' >> ~/.zshrc && exec $SHELL\n```\n\n## Environment variables\n\n| Var | Required | Purpose |\n|---|---|---|\n| `CORE_URL` | yes | The spec-room core API, usually `https://ai-spec-room.vercel.app` |\n| `ROOM_ID` | yes | Room UUID |\n| `PARTICIPANT_TOKEN` | yes | Your A or B token for that room |\n| `MY_CONTEXT_DIR` | no | Absolute path to private notes for this room |\n| `ASR_MY_CONTEXT_DIR` | no | Shell-level default used when `MY_CONTEXT_DIR` is not set |\n","readmeFilename":"README.md"}