{"_id":"@crosmos/crosmos-mcp","_rev":"6-21315b494de96427724effb0ae01ac20","name":"@crosmos/crosmos-mcp","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.1":{"name":"@crosmos/crosmos-mcp","version":"0.1.1","keywords":["mcp","memory","ai","rag","knowledge-graph"],"author":{"name":"Crosmos"},"license":"MIT","_id":"@crosmos/crosmos-mcp@0.1.1","maintainers":[{"name":"iiviie","email":"divyanshverma158@gmail.com"}],"homepage":"https://github.com/crosmos-org/crosmos-mcp#readme","bugs":{"url":"https://github.com/crosmos-org/crosmos-mcp/issues"},"bin":{"crosmos-mcp":"dist/stdio.js","crosmos-mcp-http":"dist/http.js"},"dist":{"shasum":"c3b72cdef322cbf3c2651598cbed91da108a44a1","tarball":"https://registry.npmjs.org/@crosmos/crosmos-mcp/-/crosmos-mcp-0.1.1.tgz","fileCount":98,"integrity":"sha512-fXKS0cvv3RC9I/RuIt5+rLREYuemOs6p8PrSMcmA30Kr1J3B6gbnTwe1gqog95qUnIOGBdG6aZHwDIAzGkiOWQ==","signatures":[{"sig":"MEUCIBGX3ztM5D8NVolpqDCMSFvnsjmT8Qp/r6bI4lqqwdysAiEAySr5n7v6UYIH+aTshCFfyUaBbW6l7d8WnnR+o/atTZs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":147983},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./server":{"types":"./dist/server.d.ts","default":"./dist/server.js"}},"gitHead":"f5ff19226d380d30ea270abc041a0651090289f2","scripts":{"dev":"bun run --watch src/stdio.ts","lint":"biome check .","build":"tsc","start":"bun run src/stdio.ts","format":"biome format --write .","dev:http":"bun run --watch src/http.ts","lint:fix":"biome check --write .","typecheck":"tsc --noEmit","start:http":"bun run src/http.ts","postinstall":"node dist/postinstall.js","build:docker":"bun build ./src/stdio.ts ./src/http.ts ./src/server.ts --outdir ./dist --target node --splitting","typecheck:all":"tsc --noEmit -p tsconfig.docker.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"iiviie","email":"divyanshverma158@gmail.com"},"repository":{"url":"git+https://github.com/crosmos-org/crosmos-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Crosmos Memory Engine with hybrid retrieval","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.0","@clack/prompts":"^1.2.0","@modelcontextprotocol/sdk":"^1.10.0"},"_hasShrinkwrap":false,"devDependencies":{"express":"^5.2.1","@types/bun":"latest","typescript":"^5.7.0","@types/node":"^22.0.0","@biomejs/biome":"^1.9.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/crosmos-mcp_0.1.1_1777190353586_0.39251578239873974","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@crosmos/crosmos-mcp","version":"0.2.0","keywords":["mcp","memory","ai","rag","knowledge-graph"],"author":{"name":"Crosmos"},"license":"MIT","_id":"@crosmos/crosmos-mcp@0.2.0","maintainers":[{"name":"iiviie","email":"divyanshverma158@gmail.com"}],"homepage":"https://github.com/crosmos-org/crosmos-mcp#readme","bugs":{"url":"https://github.com/crosmos-org/crosmos-mcp/issues"},"bin":{"crosmos-mcp":"dist/stdio.js","crosmos-mcp-http":"dist/http.js"},"dist":{"shasum":"f5b24e5468baf57f388e4a666cf798da898261e3","tarball":"https://registry.npmjs.org/@crosmos/crosmos-mcp/-/crosmos-mcp-0.2.0.tgz","fileCount":98,"integrity":"sha512-c9v2uNR7I5d3ICTDy8crnCTLJSiO65hTqNQabQu7lqj+bHrOe1wOaG5UbI1M4s31K3PZBPycHJPdorjgYArQag==","signatures":[{"sig":"MEQCIBfzb6RieSrek+jMZKIKaTV6x2jLLhbeq8/+pt7EUlTaAiBvVlNTYzB27W9bfY0MJElFPyaH0xbLE6L1trFcitTLSw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154420},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./server":{"types":"./dist/server.d.ts","default":"./dist/server.js"}},"gitHead":"734932112ead63b8f513845e1eaf81fa635e228c","scripts":{"dev":"bun run --watch src/stdio.ts","lint":"biome check .","build":"tsc","start":"bun run src/stdio.ts","format":"biome format --write .","dev:http":"bun run --watch src/http.ts","lint:fix":"biome check --write .","typecheck":"tsc --noEmit","start:http":"bun run src/http.ts","postinstall":"node dist/postinstall.js","build:docker":"bun build ./src/stdio.ts ./src/http.ts ./src/server.ts --outdir ./dist --target node --splitting","typecheck:all":"tsc --noEmit -p tsconfig.docker.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"iiviie","email":"divyanshverma158@gmail.com"},"repository":{"url":"git+https://github.com/crosmos-org/crosmos-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Crosmos Memory Engine with hybrid retrieval","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.0","@clack/prompts":"^1.2.0","@modelcontextprotocol/sdk":"^1.10.0"},"_hasShrinkwrap":false,"devDependencies":{"express":"^5.2.1","@types/bun":"latest","typescript":"^5.7.0","@types/node":"^22.0.0","@biomejs/biome":"^1.9.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/crosmos-mcp_0.2.0_1777278569087_0.6666733030747607","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@crosmos/crosmos-mcp","version":"0.2.1","keywords":["mcp","memory","ai","rag","knowledge-graph"],"author":{"name":"Crosmos"},"license":"MIT","_id":"@crosmos/crosmos-mcp@0.2.1","maintainers":[{"name":"rachit_03","email":"honey032004@gmail.com"},{"name":"ryadi","email":"aditya.chaudhary0523@gmail.com"},{"name":"iiviie","email":"divyanshverma158@gmail.com"}],"homepage":"https://github.com/crosmos-org/crosmos-mcp#readme","bugs":{"url":"https://github.com/crosmos-org/crosmos-mcp/issues"},"bin":{"crosmos-mcp":"dist/stdio.js","crosmos-mcp-http":"dist/http.js"},"dist":{"shasum":"37a8632e62c186bd995e6fc227562cf59cc4c66b","tarball":"https://registry.npmjs.org/@crosmos/crosmos-mcp/-/crosmos-mcp-0.2.1.tgz","fileCount":102,"integrity":"sha512-j2h6wtlaQ4zWH/xGOGQFWUfPgRHO26YAk+Vm8+yDl2EWzvberi4YXrcWk4clbIZpgcW+U1qFGXO9ap0krPx+wg==","signatures":[{"sig":"MEQCICdB7JzVVYHCj2X4+/QZTO6K51acCHRj3It3ipZkO1QeAiBNuN4LoKRbCwqglSaVHIFxiaRzABOtnGS7VGKGiD3IzQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":174380},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./server":{"types":"./dist/server.d.ts","default":"./dist/server.js"}},"gitHead":"623b45d4470640de528caecc68f81364d42b526d","scripts":{"dev":"bun run --watch src/stdio.ts","lint":"biome check .","build":"tsc","start":"bun run src/stdio.ts","format":"biome format --write .","dev:http":"bun run --watch src/http.ts","lint:fix":"biome check --write .","typecheck":"tsc --noEmit","start:http":"bun run src/http.ts","postinstall":"node dist/postinstall.js","build:docker":"bun build ./src/stdio.ts ./src/http.ts ./src/server.ts --outdir ./dist --target node --splitting","typecheck:all":"tsc --noEmit -p tsconfig.docker.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"iiviie","email":"divyanshverma158@gmail.com"},"repository":{"url":"git+https://github.com/crosmos-org/crosmos-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Crosmos Memory Engine with hybrid retrieval","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.0","@clack/prompts":"^1.2.0","@modelcontextprotocol/sdk":"^1.10.0"},"_hasShrinkwrap":false,"devDependencies":{"express":"^5.2.1","@types/bun":"latest","typescript":"^5.7.0","@types/node":"^22.0.0","@biomejs/biome":"^1.9.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/crosmos-mcp_0.2.1_1777306079448_0.9971293265971926","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@crosmos/crosmos-mcp","version":"0.2.2","keywords":["mcp","memory","ai","rag","knowledge-graph"],"author":{"name":"Crosmos"},"license":"MIT","_id":"@crosmos/crosmos-mcp@0.2.2","maintainers":[{"name":"rachit_03","email":"honey032004@gmail.com"},{"name":"ryadi","email":"aditya.chaudhary0523@gmail.com"},{"name":"iiviie","email":"divyanshverma158@gmail.com"}],"homepage":"https://github.com/crosmos-org/crosmos-mcp#readme","bugs":{"url":"https://github.com/crosmos-org/crosmos-mcp/issues"},"bin":{"crosmos-mcp":"dist/stdio.js","crosmos-mcp-http":"dist/http.js"},"dist":{"shasum":"4890edb0f7b0fa09f05ecaad3f545f125fc8cfd8","tarball":"https://registry.npmjs.org/@crosmos/crosmos-mcp/-/crosmos-mcp-0.2.2.tgz","fileCount":102,"integrity":"sha512-2gLzMm6KRy1WaBV3i1aRyHiBH8M2jG6BpunXXjSYWE6Q69GzocMXhsBh4OKrzwNpx8dQiU6HbGzNSU3wtlB1NA==","signatures":[{"sig":"MEQCIAzoYbvuq5JuGTtb7TeJ1Bw129R5SLW7xhp8RzrmsncvAiBGpr3jiqHhGtNaVc0VgDBx2PGC2+KfMjiiufqbrdn38w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":174380},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./server":{"types":"./dist/server.d.ts","default":"./dist/server.js"}},"gitHead":"1c56764c94f039564dd9d865b65d6c2d0a0c714e","scripts":{"dev":"bun run --watch src/stdio.ts","lint":"biome check .","build":"tsc","start":"bun run src/stdio.ts","format":"biome format --write .","dev:http":"bun run --watch src/http.ts","lint:fix":"biome check --write .","typecheck":"tsc --noEmit","start:http":"bun run src/http.ts","postinstall":"node dist/postinstall.js","build:docker":"bun build ./src/stdio.ts ./src/http.ts ./src/server.ts --outdir ./dist --target node --splitting","typecheck:all":"tsc --noEmit -p tsconfig.docker.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"iiviie","email":"divyanshverma158@gmail.com"},"repository":{"url":"git+https://github.com/crosmos-org/crosmos-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Crosmos Memory Engine with hybrid retrieval","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.0","@clack/prompts":"^1.2.0","@modelcontextprotocol/sdk":"^1.10.0"},"_hasShrinkwrap":false,"devDependencies":{"express":"^5.2.1","@types/bun":"latest","typescript":"^5.7.0","@types/node":"^22.0.0","@biomejs/biome":"^1.9.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/crosmos-mcp_0.2.2_1777373930287_0.40743788883614873","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@crosmos/crosmos-mcp","version":"0.2.3","type":"module","description":"MCP server for Crosmos Memory Engine with hybrid retrieval","author":{"name":"Crosmos"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/crosmos-org/crosmos-mcp.git"},"keywords":["mcp","memory","ai","rag","knowledge-graph"],"main":"dist/index.js","types":"dist/index.d.ts","bin":{"crosmos-mcp":"dist/stdio.js","crosmos-mcp-http":"dist/http.js"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./server":{"types":"./dist/server.d.ts","default":"./dist/server.js"}},"scripts":{"build":"tsc","build:docker":"bun build ./src/stdio.ts ./src/http.ts ./src/server.ts --outdir ./dist --target node --splitting","postinstall":"node dist/postinstall.js","dev":"bun run --watch src/stdio.ts","dev:http":"bun run --watch src/http.ts","start":"bun run src/stdio.ts","start:http":"bun run src/http.ts","lint":"biome check .","lint:fix":"biome check --write .","format":"biome format --write .","typecheck":"tsc --noEmit","typecheck:all":"tsc --noEmit -p tsconfig.docker.json","prepublishOnly":"npm run build"},"dependencies":{"@clack/prompts":"^1.2.0","@modelcontextprotocol/sdk":"^1.10.0","zod":"^3.24.0"},"devDependencies":{"@biomejs/biome":"^1.9.0","@types/bun":"latest","@types/express":"^5.0.6","@types/node":"^22.0.0","express":"^5.2.1","typescript":"^5.7.0"},"engines":{"node":">=18"},"gitHead":"dc5b4733b1ea826ae6ca37b4cb85c9d588ddbe6f","_id":"@crosmos/crosmos-mcp@0.2.3","bugs":{"url":"https://github.com/crosmos-org/crosmos-mcp/issues"},"homepage":"https://github.com/crosmos-org/crosmos-mcp#readme","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-5BJCnB0ocpnHC5012NvzM7OxmFOjakx9qMUWqGXptguMDzSu/d+NsZFjApre9V0ib3T6R+2yZKzZIg/foRaAlA==","shasum":"2c6015bf38b6432d3bddcd7222d1ef8c53f46634","tarball":"https://registry.npmjs.org/@crosmos/crosmos-mcp/-/crosmos-mcp-0.2.3.tgz","fileCount":102,"unpackedSize":182474,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDywlgRhrLPu+XRodR0+ERmAYzsoc6D9Sn8IXxisVyICQIgM4ZyhIX+43W33ZfGFEnnUH9gENdmMg7kiTxPinXESuY="}]},"_npmUser":{"name":"iiviie","email":"divyanshverma158@gmail.com"},"directories":{},"maintainers":[{"name":"rachit_03","email":"honey032004@gmail.com"},{"name":"ryadi","email":"aditya.chaudhary0523@gmail.com"},{"name":"iiviie","email":"divyanshverma158@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/crosmos-mcp_0.2.3_1782501835606_0.9910381216184694"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-26T07:59:13.519Z","modified":"2026-06-26T19:23:55.907Z","0.1.1":"2026-04-26T07:59:13.730Z","0.2.0":"2026-04-27T08:29:29.232Z","0.2.1":"2026-04-27T16:07:59.587Z","0.2.2":"2026-04-28T10:58:50.448Z","0.2.3":"2026-06-26T19:23:55.754Z"},"bugs":{"url":"https://github.com/crosmos-org/crosmos-mcp/issues"},"author":{"name":"Crosmos"},"license":"MIT","homepage":"https://github.com/crosmos-org/crosmos-mcp#readme","keywords":["mcp","memory","ai","rag","knowledge-graph"],"repository":{"type":"git","url":"git+https://github.com/crosmos-org/crosmos-mcp.git"},"description":"MCP server for Crosmos Memory Engine with hybrid retrieval","maintainers":[{"name":"rachit_03","email":"honey032004@gmail.com"},{"name":"ryadi","email":"aditya.chaudhary0523@gmail.com"},{"name":"iiviie","email":"divyanshverma158@gmail.com"}],"readme":"# Crosmos MCP Server\n\n> **Beta** — Crosmos is in early access. APIs and features may change. Feedback welcome at [github.com/crosmos-org/crosmos-mcp](https://github.com/crosmos-org/crosmos-mcp).\n\nMCP server for the Crosmos memory layer.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `crosmos_search_memories` | Semantic + keyword + graph retrieval |\n| `crosmos_add_memory` | Store content with auto entity/relation extraction |\n| `crosmos_list_spaces` | List available memory spaces |\n| `crosmos_health_check` | Verify API connectivity and status |\n\n## Quick Start\n\n```bash\nnpx @crosmos/crosmos-mcp setup\n```\n\nThis runs the interactive setup:\n\n1. **Authenticate** — Enter your API key (get one at [console.crosmos.dev](https://console.crosmos.dev/))\n2. **Install to clients** — Auto-detects installed MCP clients (Claude Desktop, Claude Code, opencode, Cursor, VS Code, Windsurf, Cline, Roo-Cline, Zed, Kimi CLI) and writes the server config\n3. **Install skill** — Auto-detects your AI editor(s) and installs the Crosmos skill\n\nNo global install needed — `npx` handles everything. Clients are configured to run `npx -y @crosmos/crosmos-mcp` so they always pick up the latest version.\n\n## Manual Setup\n\n### 1. Authenticate\n\n```bash\nnpx @crosmos/crosmos-mcp auth login\n```\n\nOr set the environment variable:\n\n```bash\nexport CROSMOS_API_KEY=csk_your_api_key_here\n```\n\n### 2. Configure your client\n\n<details>\n<summary>Claude Desktop</summary>\n\nConfig location:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"crosmos-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@crosmos/crosmos-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>Claude Code</summary>\n\n```bash\nclaude mcp add crosmos-memory -- npx -y @crosmos/crosmos-mcp\n```\n\n</details>\n\n<details>\n<summary>opencode</summary>\n\n`~/.config/opencode/opencode.json`:\n\n```json\n{\n  \"mcp\": {\n    \"crosmos-memory\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@crosmos/crosmos-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>Cursor</summary>\n\n`~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"crosmos-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@crosmos/crosmos-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>VS Code</summary>\n\n- **macOS**: `~/Library/Application Support/Code/User/mcp.json`\n- **Linux**: `~/.config/Code/User/mcp.json`\n- **Windows**: `%APPDATA%\\Code\\User\\mcp.json`\n\n```json\n{\n  \"servers\": {\n    \"crosmos-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@crosmos/crosmos-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>Windsurf</summary>\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"crosmos-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@crosmos/crosmos-mcp\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>Kimi CLI</summary>\n\n```bash\nkimi mcp add --transport stdio crosmos-memory -- npx -y @crosmos/crosmos-mcp\n```\n\n</details>\n\n<details>\n<summary>Other MCP clients</summary>\n\nThe server uses stdio transport. Point your client to `npx -y @crosmos/crosmos-mcp` and set:\n\n| Variable | Value |\n|----------|-------|\n| `CROSMOS_API_KEY` | Your API key (`csk_...`) |\n| `CROSMOS_API_BASE_URL` | `https://api.crosmos.dev` (default) |\n\n</details>\n\n### 3. (Optional) Install the skill\n\n```bash\nnpx @crosmos/crosmos-mcp skill install opencode    # or: cursor, claude-code, windsurf, vscode, kimi-cli\n```\n\n## CLI Reference\n\n```bash\nnpx @crosmos/crosmos-mcp                     # Start MCP server (stdio)\nnpx @crosmos/crosmos-mcp setup               # Interactive setup (auth + client install + skill)\nnpx @crosmos/crosmos-mcp auth login          # Authenticate with API key\nnpx @crosmos/crosmos-mcp auth login --base-url URL # Custom API base URL\nnpx @crosmos/crosmos-mcp auth logout         # Remove stored credentials\nnpx @crosmos/crosmos-mcp auth status         # Show auth state\nnpx @crosmos/crosmos-mcp skill install <client>  # Install Crosmos skill\n```\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `CROSMOS_API_KEY` | API key (overrides credentials file) | — |\n| `CROSMOS_API_BASE_URL` | API base URL | `https://api.crosmos.dev` |\n| `CROSMOS_API_TIMEOUT` | Request timeout (ms) | `30000` |\n| `DEFAULT_SPACE_ID` | Default memory space UUID | — |\n| `DEFAULT_SPACE_NAME` | Default memory space name (resolved via `/spaces?name=`); ignored if `DEFAULT_SPACE_ID` is set | — |\n\nCredential resolution order: `CROSMOS_API_KEY` env var → `~/.crosmos/credentials.json` → error.\n\n## Development\n\n```bash\nnpm run dev          # stdio mode with watch\nnpm run dev:http     # HTTP mode with watch\nnpm run build        # compile TypeScript\nnpm run lint         # biome check\nnpm run format       # biome format\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}