{"_id":"@ashwindojo/codeatlas-mcp","_rev":"5-69b872f5f5031b0e7ea6da63c4eea14b","name":"@ashwindojo/codeatlas-mcp","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@ashwindojo/codeatlas-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","frontend","architecture","langchain","ai","claude"],"license":"MIT","_id":"@ashwindojo/codeatlas-mcp@0.1.0","maintainers":[{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"}],"homepage":"https://github.com/yourusername/codeatlas#readme","bugs":{"url":"https://github.com/yourusername/codeatlas/issues"},"bin":{"codeatlas-mcp":"dist/server.js"},"dist":{"shasum":"053f23b792c55c7990116993695155e19bb015e7","tarball":"https://registry.npmjs.org/@ashwindojo/codeatlas-mcp/-/codeatlas-mcp-0.1.0.tgz","fileCount":21,"integrity":"sha512-R/RvtwHW8c8KeiFu+sopriFRaxzy9oAOu73XwluklLTCDAg5w2INz8ejyMTBqVZW69Ni7J+HxNveAAfbKxPBcA==","signatures":[{"sig":"MEYCIQC8E9+7B6P2G4Df6nJe7QVHplXzhPM+qrEXHuE6qB4cPgIhAOLL9Tpx6yx0AMPydFuCRffi+ZpWAfHBdtKZpuzQi0D4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48626},"main":"./dist/index.js","type":"module","_from":"file:ashwindojo-codeatlas-mcp-0.1.0.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc -p tsconfig.json --watch","build":"tsc -p tsconfig.json","clean":"rm -rf dist","start":"node dist/server.js","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"},"_resolved":"/private/var/folders/vp/5x74jmdj4j79tw44_vvwl6480000gn/T/32b9db97f568cb185a036bbacc24927e/ashwindojo-codeatlas-mcp-0.1.0.tgz","_integrity":"sha512-R/RvtwHW8c8KeiFu+sopriFRaxzy9oAOu73XwluklLTCDAg5w2INz8ejyMTBqVZW69Ni7J+HxNveAAfbKxPBcA==","repository":{"url":"git+https://github.com/yourusername/codeatlas.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for CodeAtlas — frontend flow intelligence via Model Context Protocol","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.22.4","langchain":"^0.3.0","@langchain/core":"^0.3.0","@langchain/openai":"^0.3.0","@modelcontextprotocol/sdk":"^1.5.0","@ashwindojo/codeatlas-core":"0.1.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/codeatlas-mcp_0.1.0_1772370821025_0.0031066640398687007","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ashwindojo/codeatlas-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","frontend","architecture","langchain","ai","claude"],"license":"MIT","_id":"@ashwindojo/codeatlas-mcp@0.1.1","maintainers":[{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"}],"homepage":"https://github.com/yourusername/codeatlas#readme","bugs":{"url":"https://github.com/yourusername/codeatlas/issues"},"bin":{"codeatlas-mcp":"dist/server.js"},"dist":{"shasum":"b576b9eafb09b97c30f38bba695ad9577e1a39a2","tarball":"https://registry.npmjs.org/@ashwindojo/codeatlas-mcp/-/codeatlas-mcp-0.1.1.tgz","fileCount":21,"integrity":"sha512-MoEwPjntKCIBO+KRt8B5rSJMCHZDK8uD+2zFWu7g7v1nF4RxZkTIhzfw4mK7/w1dYDq+Vx0VeZnd8k55ZxtWJA==","signatures":[{"sig":"MEUCIFO8UUmDJJpr3BF7bM3aTCOK1br4U8GYpKLhd6GXk9BJAiEA3VlYozIY9OtRSjH3rpSC/zL7xVW3EDRZU1YBOp9dRiY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48626},"main":"./dist/index.js","type":"module","_from":"file:ashwindojo-codeatlas-mcp-0.1.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc -p tsconfig.json --watch","build":"tsc -p tsconfig.json","clean":"rm -rf dist","start":"node dist/server.js","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"},"_resolved":"/private/var/folders/vp/5x74jmdj4j79tw44_vvwl6480000gn/T/25c5dd0f092ced278aeab35079c1c707/ashwindojo-codeatlas-mcp-0.1.1.tgz","_integrity":"sha512-MoEwPjntKCIBO+KRt8B5rSJMCHZDK8uD+2zFWu7g7v1nF4RxZkTIhzfw4mK7/w1dYDq+Vx0VeZnd8k55ZxtWJA==","repository":{"url":"git+https://github.com/yourusername/codeatlas.git","type":"git"},"_npmVersion":"11.9.0","description":"MCP server for CodeAtlas — frontend flow intelligence via Model Context Protocol","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.22.4","langchain":"^0.3.0","@langchain/core":"^0.3.0","@langchain/openai":"^0.3.0","@modelcontextprotocol/sdk":"^1.5.0","@ashwindojo/codeatlas-core":"0.1.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/codeatlas-mcp_0.1.1_1772371301095_0.6995725027287154","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ashwindojo/codeatlas-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","frontend","architecture","langchain","ai","claude","cursor","codeatlas","react","vue"],"license":"MIT","_id":"@ashwindojo/codeatlas-mcp@0.1.2","maintainers":[{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"}],"bin":{"codeatlas-mcp":"dist/server.js"},"dist":{"shasum":"1d94484dd9cf05090e0344d2c79a791f4430de71","tarball":"https://registry.npmjs.org/@ashwindojo/codeatlas-mcp/-/codeatlas-mcp-0.1.2.tgz","fileCount":22,"integrity":"sha512-PucJlnMKzcnrzDvQZcpu/Xnj0pJ0pVKiUSJjFw5EHVut29Dk5cVXfqFffK6w55+mdiW2RLFiHqOE26rmCmfnmA==","signatures":[{"sig":"MEYCIQCYZ8SDx/lpY6X0qykZXBv9KCUFAb2ti6EWyowzVpxTWwIhAP3ez3o8wC3kZrYXzDIQYZ5sPFTGPiIx+UYC3wJo0C4I","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58241},"main":"./dist/index.js","type":"module","_from":"file:ashwindojo-codeatlas-mcp-0.1.2.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc -p tsconfig.json --watch","build":"tsc -p tsconfig.json","clean":"rm -rf dist","start":"node dist/server.js","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"},"_resolved":"/private/var/folders/vp/5x74jmdj4j79tw44_vvwl6480000gn/T/6a9648da7b8e12538484c899a0ffc378/ashwindojo-codeatlas-mcp-0.1.2.tgz","_integrity":"sha512-PucJlnMKzcnrzDvQZcpu/Xnj0pJ0pVKiUSJjFw5EHVut29Dk5cVXfqFffK6w55+mdiW2RLFiHqOE26rmCmfnmA==","_npmVersion":"11.9.0","description":"Standalone MCP server for CodeAtlas — expose frontend flow intelligence to Claude, Cursor, and any MCP-compatible AI tool","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.22.4","langchain":"^0.3.0","@langchain/core":"^0.3.0","@langchain/openai":"^0.3.0","@modelcontextprotocol/sdk":"^1.5.0","@ashwindojo/codeatlas-core":"0.1.2"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/codeatlas-mcp_0.1.2_1772371726425_0.23804522853567045","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@ashwindojo/codeatlas-mcp","version":"0.1.3","keywords":["mcp","model-context-protocol","frontend","architecture","langchain","ai","claude","cursor","codeatlas","react","vue"],"license":"MIT","_id":"@ashwindojo/codeatlas-mcp@0.1.3","maintainers":[{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"}],"bin":{"codeatlas-mcp":"dist/server.js"},"dist":{"shasum":"a92807b533df9e6f588671e1fad1a60938e210f5","tarball":"https://registry.npmjs.org/@ashwindojo/codeatlas-mcp/-/codeatlas-mcp-0.1.3.tgz","fileCount":22,"integrity":"sha512-JUbNcfEGnTJr+UoD/SmImYuNzt9DKf8KrpdcAyWNZ7MxmvWCfoQC10vB/VkPtsMqk3byvYy294rAX75PvNi6ig==","signatures":[{"sig":"MEYCIQC3Yrk7XYV4U7Z2fDsA6jfq+Rb09NicomBGZKBj/xrK9AIhAOD8WuOISDuVaxMCo5juFLJ3591a+RZFCgCxKUFYIUq0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52890},"main":"./dist/index.js","type":"module","_from":"file:ashwindojo-codeatlas-mcp-0.1.3.tgz","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsc -p tsconfig.json --watch","build":"tsc -p tsconfig.json","clean":"rm -rf dist","start":"node dist/server.js","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"},"_resolved":"/private/var/folders/vp/5x74jmdj4j79tw44_vvwl6480000gn/T/cd23ba44a54537e9d53e7366e89774f0/ashwindojo-codeatlas-mcp-0.1.3.tgz","_integrity":"sha512-JUbNcfEGnTJr+UoD/SmImYuNzt9DKf8KrpdcAyWNZ7MxmvWCfoQC10vB/VkPtsMqk3byvYy294rAX75PvNi6ig==","_npmVersion":"11.9.0","description":"Standalone MCP server for CodeAtlas — expose frontend flow intelligence to Claude, Cursor, and any MCP-compatible AI tool","directories":{},"_nodeVersion":"24.14.0","dependencies":{"zod":"^3.22.4","langchain":"^0.3.0","@langchain/core":"^0.3.0","@langchain/openai":"^0.3.0","@modelcontextprotocol/sdk":"^1.5.0","@ashwindojo/codeatlas-core":"0.1.3"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/codeatlas-mcp_0.1.3_1772371999662_0.26885238908096354","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@ashwindojo/codeatlas-mcp","version":"0.1.4","description":"Standalone MCP server for CodeAtlas — expose frontend flow intelligence to Claude, Cursor, and any MCP-compatible AI tool","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"bin":{"codeatlas-mcp":"dist/server.js"},"scripts":{"build":"tsc -p tsconfig.json","dev":"tsc -p tsconfig.json --watch","clean":"rm -rf dist","typecheck":"tsc -p tsconfig.json --noEmit","start":"node dist/server.js"},"dependencies":{"@ashwindojo/codeatlas-core":"workspace:*","@langchain/core":"^0.3.0","@langchain/openai":"^0.3.0","@modelcontextprotocol/sdk":"^1.5.0","langchain":"^0.3.0","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.3.3"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"keywords":["mcp","model-context-protocol","frontend","architecture","langchain","ai","claude","cursor","codeatlas","react","vue"],"license":"MIT","engines":{"node":">=18.0.0"},"_id":"@ashwindojo/codeatlas-mcp@0.1.4","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-l/CB6audWqaXLynRj6zdVO+qEb3yw81IUjgUM0MnKbpAnRoNwPyRr981qWaRylg82enuBQicI2yN8xWQbCzO8g==","shasum":"afe6ee4641813eac038adc4356d84785a9d7301a","tarball":"https://registry.npmjs.org/@ashwindojo/codeatlas-mcp/-/codeatlas-mcp-0.1.4.tgz","fileCount":22,"unpackedSize":56221,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCw+yEtxwSRQbUtMdz4dRs+cm44EoeUfAXbIqffm2scOAIgIR/6gRQ03Lw5Wzjh5YO/d8vKX0WhFBXnnFbbvyACEvo="}]},"_npmUser":{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"},"directories":{},"maintainers":[{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/codeatlas-mcp_0.1.4_1772373362386_0.29277909261966184"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-01T13:13:40.943Z","modified":"2026-03-01T13:56:02.692Z","0.1.0":"2026-03-01T13:13:41.162Z","0.1.1":"2026-03-01T13:21:41.235Z","0.1.2":"2026-03-01T13:28:46.564Z","0.1.3":"2026-03-01T13:33:19.844Z","0.1.4":"2026-03-01T13:56:02.588Z"},"license":"MIT","keywords":["mcp","model-context-protocol","frontend","architecture","langchain","ai","claude","cursor","codeatlas","react","vue"],"description":"Standalone MCP server for CodeAtlas — expose frontend flow intelligence to Claude, Cursor, and any MCP-compatible AI tool","maintainers":[{"name":"ashwindojo","email":"ashwindojo.ceo@gmail.com"}],"readme":"# @ashwindojo/codeatlas-mcp\n\n[![npm](https://img.shields.io/npm/v/@ashwindojo/codeatlas-mcp.svg)](https://www.npmjs.com/package/@ashwindojo/codeatlas-mcp)\n[![downloads](https://img.shields.io/npm/dm/@ashwindojo/codeatlas-mcp.svg)](https://www.npmjs.com/package/@ashwindojo/codeatlas-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/Model_Context_Protocol-1.x-8A2BE2)](https://modelcontextprotocol.io)\n\n**Let Claude Desktop and Cursor understand your frontend codebase — without a running dev server.**\n\nPoint this standalone MCP server at any React, Vue, or Svelte project and AI tools instantly gain structured knowledge of your business flows, state management, API layers, team ownership, and critical paths. Powered by the [Model Context Protocol](https://modelcontextprotocol.io) with optional semantic search via LangChain + OpenAI.\n\n---\n\n## Install\n\n```bash\nnpm install -D @ashwindojo/codeatlas-mcp\n```\n\n## Setup — 2 steps\n\n**Step 1 — Index your project**\n\n```bash\nnpx @ashwindojo/codeatlas-core index ./my-app\n# Creates .codeatlas/index.json\n```\n\n**Step 2 — Point Claude Desktop at the server**\n\nIn `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"codeatlas\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/my-app/node_modules/@ashwindojo/codeatlas-mcp/dist/server.js\"],\n      \"env\": {\n        \"CODEATLAS_ROOT\": \"/absolute/path/to/my-app\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Done.\n\n---\n\n## Connect to Cursor\n\nIn **Cursor → Settings → MCP**:\n\n```json\n{\n  \"mcpServers\": {\n    \"codeatlas\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/my-app/node_modules/@ashwindojo/codeatlas-mcp/dist/server.js\"],\n      \"env\": {\n        \"CODEATLAS_ROOT\": \"/absolute/path/to/my-app\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## What you can ask Claude\n\nOnce connected, ask anything about your codebase:\n\n> *\"Index my project at /workspace/my-app, then list all business flows\"*\n> *\"What Redux state does the payments flow use?\"*\n> *\"Which team owns the auth feature?\"*\n> *\"Show me all business-critical code paths\"*\n> *\"What third-party integrations does the checkout flow have?\"*\n\n## Available MCP tools\n\n| Tool | Description |\n|---|---|\n| `index_repo` | Scan and index a project (run this first) |\n| `get_repo_context` | Full overview: flows, states, APIs, owners, critical paths |\n| `get_flow_context` | Deep dive into one business flow |\n| `get_component_context` | Context for one annotated component |\n| `list_flows` | All flows with component/state/API counts |\n| `search_flows` | Search across names, files, and annotations |\n| `ask_codebase` | Natural language Q&A — requires `OPENAI_API_KEY` |\n\n## Enable semantic search (optional)\n\nAdd your OpenAI key to unlock vector search and natural-language Q&A:\n\n```json\n\"env\": {\n  \"CODEATLAS_ROOT\": \"/absolute/path/to/my-app\",\n  \"OPENAI_API_KEY\": \"sk-...\"\n}\n```\n\n| Feature | Without key | With key |\n|---|---|---|\n| All query tools | ✅ Full text search | ✅ Vector similarity search |\n| `ask_codebase` | ❌ | ✅ GPT-powered Q&A |\n\n## When to use this vs the Vite plugin\n\n| Scenario | Use |\n|---|---|\n| Active `vite dev` session | [`@ashwindojo/codeatlas-vite-plugin`](https://www.npmjs.com/package/@ashwindojo/codeatlas-vite-plugin) — live, updates on save |\n| Claude Desktop, CI, non-Vite projects | **This package** — reads from `.codeatlas/index.json` |\n\n## Keep the index fresh in CI\n\n```yaml\n# .github/workflows/codeatlas.yml\n- name: Update CodeAtlas index\n  run: npx @ashwindojo/codeatlas-core index .\n- uses: actions/upload-artifact@v4\n  with:\n    name: codeatlas-index\n    path: .codeatlas/index.json\n```\n\n---\n\n## Part of the CodeAtlas ecosystem\n\n| Package | What it does |\n|---|---|\n| [`@ashwindojo/codeatlas-core`](https://www.npmjs.com/package/@ashwindojo/codeatlas-core) | Parser, indexer, CLI |\n| [`@ashwindojo/codeatlas-vite-plugin`](https://www.npmjs.com/package/@ashwindojo/codeatlas-vite-plugin) | Live MCP server inside `vite dev` |\n| **`@ashwindojo/codeatlas-mcp`** | Standalone MCP server for Claude Desktop & Cursor ← you are here |\n\n---\n\nMIT © 2026\n","readmeFilename":"README.md"}