{"_id":"@anhndh1997/workspace-map-mcp","name":"@anhndh1997/workspace-map-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@anhndh1997/workspace-map-mcp","version":"0.2.0","description":"MCP server that maps a workspace: markdown folder/file tree + code relation maps (types, inheritance, imports, calls) for AI-assisted navigation.","type":"module","license":"MIT","repository":{"type":"git","url":"git+https://github.com/AnhNguyenDaenet/WorkplaceWorkTree.git"},"bugs":{"url":"https://github.com/AnhNguyenDaenet/WorkplaceWorkTree/issues"},"homepage":"https://github.com/AnhNguyenDaenet/WorkplaceWorkTree#readme","keywords":["mcp","model-context-protocol","workspace","codemap","code-navigation","tree-sitter","ai-agent","copilot"],"publishConfig":{"access":"public"},"engines":{"node":">=20"},"bin":{"workspace-map-mcp":"dist/index.js"},"main":"dist/index.js","scripts":{"build":"tsc -p tsconfig.json","test":"vitest run","test:watch":"vitest","lint":"eslint .","format":"prettier --write .","grammars":"node scripts/fetch-grammars.mjs","prepublishOnly":"node scripts/fetch-grammars.mjs && tsc -p tsconfig.json","prepare":"node scripts/fetch-grammars.mjs --soft && node scripts/build-if-needed.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","ignore":"^7.0.0","web-tree-sitter":"~0.24.7","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.10.0","eslint":"^9.17.0","prettier":"^3.4.0","tree-sitter-wasms":"^0.1.12","tsx":"^4.19.0","typescript":"^5.7.0","typescript-eslint":"^8.19.0","vitest":"^3.0.0"},"_id":"@anhndh1997/workspace-map-mcp@0.2.0","gitHead":"ae72a5cfb42643157a36227c32a89074ccc3963d","_nodeVersion":"20.17.0","_npmVersion":"11.0.0","dist":{"integrity":"sha512-jFr1CVcbrS4bC9Mf/dVv7Q7lyqXGYS/sxkua6jZuwse1OdfOL99hmejE2XmjXN01XCVXd4AuVeKhJDMaVh21rg==","shasum":"d70c5da4ef63baacf103f0d580d13a3674302cbf","tarball":"https://registry.npmjs.org/@anhndh1997/workspace-map-mcp/-/workspace-map-mcp-0.2.0.tgz","fileCount":45,"unpackedSize":11458712,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEiB+jJ/lKMNQTz/bCFHnJALU7WS9+1GlPA2BZ06CUsjAiEAwqaRQ/JreP4WH4nx06HheZ+pq+dgDdUjg6imMPpx0oM="}]},"_npmUser":{"name":"anhndh1997","email":"anhndh1997@gmail.com"},"directories":{},"maintainers":[{"name":"anhndh1997","email":"anhndh1997@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/workspace-map-mcp_0.2.0_1783519364372_0.2777130536962742"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-08T14:02:44.165Z","0.2.0":"2026-07-08T14:02:44.672Z","modified":"2026-07-08T14:02:44.832Z"},"maintainers":[{"name":"anhndh1997","email":"anhndh1997@gmail.com"}],"description":"MCP server that maps a workspace: markdown folder/file tree + code relation maps (types, inheritance, imports, calls) for AI-assisted navigation.","homepage":"https://github.com/AnhNguyenDaenet/WorkplaceWorkTree#readme","keywords":["mcp","model-context-protocol","workspace","codemap","code-navigation","tree-sitter","ai-agent","copilot"],"repository":{"type":"git","url":"git+https://github.com/AnhNguyenDaenet/WorkplaceWorkTree.git"},"bugs":{"url":"https://github.com/AnhNguyenDaenet/WorkplaceWorkTree/issues"},"license":"MIT","readme":"# workspace-map-mcp\r\n\r\nAn MCP (Model Context Protocol) server that maps any workspace into plain-markdown documents — folder/file tree plus code relations (types, inheritance, imports, calls) — so AI assistants navigate **directly** instead of searching. Offline tree-sitter WASM parsing, atomic writes, no watchers.\r\n\r\n## Quick start (fastest path: npx)\r\n\r\nAdd to your project's `.vscode/mcp.json` — done:\r\n\r\n```json\r\n{\r\n  \"servers\": {\r\n    \"workspace-map\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@anhndh1997/workspace-map-mcp\", \"--workspace\", \"${workspaceFolder}\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nOr let the CLI write that file for you (and optionally install agent guidance):\r\n\r\n```powershell\r\nnpx @anhndh1997/workspace-map-mcp init --guidance --yes\r\n```\r\n\r\nReload your MCP client, then ask your assistant to run `scan_structure` and `scan_relations`. Maps land in `<workspace>/.codemap/`.\r\n\r\nRequires Node.js ≥ 20 (or use the [Docker image](docs/docker.md)). Verify any install with `workspace-map-mcp --version`.\r\n\r\n## The four tools\r\n\r\n| Tool | What it does |\r\n|---|---|\r\n| `scan_structure` | Writes `.codemap/structure.md` — full tree, workspace-relative paths |\r\n| `scan_relations` | Writes `.codemap/relations.md` — type→file index, inheritance, imports, calls (C#, TS/JS, Python, Java, Go, Rust; import fallback elsewhere) |\r\n| `update_maps` | Incremental refresh of both maps (`{\"force\": true}` for full rebuild) |\r\n| `install_guidance` | Installs an agent skill + managed copilot-instructions section teaching assistants to use the maps |\r\n\r\n## Server CLI\r\n\r\n```text\r\nworkspace-map-mcp --workspace <abs-path> [--max-doc-lines <n>]                # stdio (default)\r\nworkspace-map-mcp --workspace <abs-path> --http --port <n> [--host <addr>]   # HTTP (localhost-bound)\r\nworkspace-map-mcp init [--target <dir>] [--transport stdio|http] [--channel npx|global|docker] [--guidance] [--yes]\r\nworkspace-map-mcp --version\r\n```\r\n\r\n## Documentation\r\n\r\n| Guide | Content |\r\n|---|---|\r\n| [docs/how-it-works.md](docs/how-it-works.md) | The maps, reading order for agents, architecture, exclusions |\r\n| [docs/install.md](docs/install.md) | All install channels: npx/registry, GitHub, global/link, Docker |\r\n| [docs/transports.md](docs/transports.md) | stdio + HTTP recipes for VS Code & Claude Desktop, security notes |\r\n| [docs/docker.md](docs/docker.md) | Container run modes, bind-mount rules, GHCR tags |\r\n| [docs/init-command.md](docs/init-command.md) | `init` flags, merge behavior, entry variants |\r\n| [docs/troubleshooting.md](docs/troubleshooting.md) | Errors and fixes, development setup |\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-4147edd5f9ea59484a8459881ae29a0e"}