{"_id":"@arstzy/nexus-mcp","_rev":"2-9aaffa810a81e1f0454ee8124ea2f9ae","name":"@arstzy/nexus-mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@arstzy/nexus-mcp","version":"0.1.0","keywords":["nexus","nexus-mcp","knowledge-graph","mcp","mermaid","documentation","docx","docusaurus","typescript-ast"],"author":{"name":"arsyaadi"},"license":"MIT","_id":"@arstzy/nexus-mcp@0.1.0","maintainers":[{"name":"arstzy","email":"arsyaadi@gmail.com"}],"bin":{"nexus":"dist/index.js","nexus-mcp":"dist/mcp/index.js"},"dist":{"shasum":"6794f04a8fe56c2daf917cea0ee2d7d2f27a1ab8","tarball":"https://registry.npmjs.org/@arstzy/nexus-mcp/-/nexus-mcp-0.1.0.tgz","fileCount":32,"integrity":"sha512-+ZdUdFgNTJdmqRkpDfSgBS8IJdo0hAmCUwATqQv0ZaT0nGyVf0redqH1kHJvt94NKYh4yocaPEGgZTankSssSw==","signatures":[{"sig":"MEYCIQDEeQ8Cyio88OX2D6t39Fc++Jnjr8EUTb+mxpLSfmpuqwIhALuD/tIWRRspOy1dkMJK4xwiDj0YuYJLcYwQjKgJKS/a","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":83698},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ec411d2aeae51ec283adfa519af89893fd7b5559","scripts":{"mcp":"node dist/mcp/index.js","test":"node dist/index.js run .","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"arstzy","email":"arsyaadi@gmail.com"},"_npmVersion":"10.9.3","description":"Nexus - Standalone AST Knowledge Graph & Master End-to-End Flow Extraction Engine","directories":{},"_nodeVersion":"22.19.0","dependencies":{"docx":"^9.2.0","typescript":"^5.7.2","@modelcontextprotocol/sdk":"^1.2.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^22.10.1"},"_npmOperationalInternal":{"tmp":"tmp/nexus-mcp_0.1.0_1785774230302_0.9559796632641302","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@arstzy/nexus-mcp","version":"0.2.0","description":"Nexus - Standalone AST Knowledge Graph & Master End-to-End Flow Extraction Engine","main":"dist/index.js","type":"module","bin":{"nexus":"dist/index.js","nexus-mcp":"dist/mcp/index.js"},"scripts":{"build":"tsc && mkdir -p dist/ui && cp src/ui/viewer.html dist/ui/viewer.html && mkdir -p dist/wasm && cp node_modules/tree-sitter-wasms/out/tree-sitter-*.wasm dist/wasm/ && cp node_modules/web-tree-sitter/web-tree-sitter.wasm dist/wasm/tree-sitter.wasm && chmod +x dist/index.js dist/mcp/index.js","start":"node dist/index.js","mcp":"node dist/mcp/index.js","test":"node dist/index.js run .","prepublishOnly":"npm run build"},"keywords":["nexus","nexus-mcp","knowledge-graph","mcp","mermaid","documentation","docx","docusaurus","typescript-ast"],"author":{"name":"arsyaadi"},"license":"MIT","dependencies":{"@ladybugdb/core":"^0.19.0","@modelcontextprotocol/sdk":"^1.2.0","docx":"^9.2.0","kuzu":"^0.11.3","tree-sitter-wasms":"^0.1.13","typescript":"^5.7.2","web-tree-sitter":"^0.26.12"},"devDependencies":{"@types/node":"^22.10.1"},"_id":"@arstzy/nexus-mcp@0.2.0","gitHead":"943439ef67ade86a542066c620fe621aac53a815","types":"./dist/index.d.ts","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Ns7u0Wouohi+seLPEcR2jQ/5JEu6Fa5/GYjt+fGhaHfaViHGpfBv/pMbo7J8QcRPkdszZhV14N8iVLhdTc55Og==","shasum":"7eb517aa90c8cba1b1dc3dd069d8d1f85b2c3ec4","tarball":"https://registry.npmjs.org/@arstzy/nexus-mcp/-/nexus-mcp-0.2.0.tgz","fileCount":82,"unpackedSize":52167745,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCmMqSRxgnvgiij35YcLoJmDla3F3uCgdzMg+uKZ+AI5QIhAJHbaclG5y0MqqV0T6vechHHRd2rQTTfV1iwQOUz5rrU"}]},"_npmUser":{"name":"arstzy","email":"arsyaadi@gmail.com"},"directories":{},"maintainers":[{"name":"arstzy","email":"arsyaadi@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nexus-mcp_0.2.0_1786207371685_0.5430218998759451"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-03T16:23:50.112Z","modified":"2026-08-08T16:42:52.055Z","0.1.0":"2026-08-03T16:23:50.446Z","0.2.0":"2026-08-08T16:42:51.924Z"},"author":{"name":"arsyaadi"},"license":"MIT","keywords":["nexus","nexus-mcp","knowledge-graph","mcp","mermaid","documentation","docx","docusaurus","typescript-ast"],"description":"Nexus - Standalone AST Knowledge Graph & Master End-to-End Flow Extraction Engine","maintainers":[{"name":"arstzy","email":"arsyaadi@gmail.com"}],"readme":"# Nexus\n\nStandalone AST Knowledge Graph & Master End-to-End Flow Extraction Engine. Turn source code into structured knowledge packages (`.nexus`), interactive visual graphs (`nexus ui`), and publishable documentation (Word `.docx` & Docusaurus).\n\nNexus analyzes codebases using a built-in High-Performance AST Knowledge Graph Analyzer (`SqliteGraphProvider`), constructs Master End-to-End System Flowcharts, groups functionality into capability-based modules, and provides an interactive Web Graph Studio.\n\nNexus operates as a CLI tool and a Model Context Protocol (MCP) Server for Claude Code, Antigravity, Cursor, and Windsurf.\n\n---\n\n## Features\n\n- **SQLite Graph Engine (`SqliteGraphProvider`)**: Fast, zero-C++ native compilation overhead graph storage using Node 22 `node:sqlite`. Persists knowledge graphs in `$HOME/.nexus/graphs/` with automatic SHA-256 project registry tracking.\n- **Interactive Web Graph Studio (`nexus ui`)**: Launches a 60FPS Cytoscape-powered Web UI on `http://localhost:3333` featuring:\n  - **Neon Glow & Multi-Color Edge Palette**: Distinct glowing visual edge colors for `CALLS`, `EXTENDS`, `IMPLEMENTS`, and `IMPORTS` relationships.\n  - **Neighborhood Focus Dimming**: Clicking or searching any node dims un-related nodes to 12% opacity so component dependency flows are instantly clear.\n  - **Continuous Galaxy Meteor Drift**: Smooth organic floating drift physics bringing concentric galaxy orbits to life.\n  - **Draggable Glassmorphic HUD Widgets**: Header, Toolbar, and Inspector Drawer cards can be freely dragged around the viewport.\n  - **Multi-Project Switcher**: Dropdown selector to switch between any indexed repository seamlessly.\n- **Multi-Language Deep AST Extractor**: Parses TypeScript, JavaScript, Go, Python, Java, Rust, PHP, C/C++, C#, Ruby, and Swift.\n- **Single-Step Master E2E Flow Engine (`nexus_generate_e2e`)**: Analyzes the codebase Knowledge Graph and generates a Master Mermaid E2E Flowchart (`flowchart TD`) with subgraph module boundaries in one step.\n- **Native Word Exporter (`.docx`)**: Converts `.nexus` packages into a single `documentation.docx` file with inline callouts, markdown tables, and embedded Mermaid process diagrams without external dependencies (`pandoc` or `python`).\n- **Docusaurus Exporter**: Exports `.nexus` packages into a ready-to-build Docusaurus documentation site with `docs/e2e-flow.md` auto-configured at the top of `sidebars.ts`.\n- **MCP Integration**: Full suite of MCP tools (`nexus_generate_e2e`, `nexus_plan`, `nexus_get_module_context`, `nexus_save_module_doc`, `nexus_finalize`, `nexus_export`).\n\n---\n\n## Interactive Web UI Visualizer\n\nLaunch the Web UI Visualizer on any repository:\n\n```bash\nnpx nexus-mcp ui /path/to/target-repo\n```\n\nThen open your browser at **`http://localhost:3333`**.\n\n---\n\n## MCP Server Setup\n\n### Claude Code\n```bash\nclaude mcp add nexus -- npx -y @arstzy/nexus-mcp\n```\n\n### Antigravity / Cursor / Windsurf (`.mcp.json` / `mcp_config.json`)\n```json\n{\n  \"mcpServers\": {\n    \"nexus\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@arstzy/nexus-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## Generation Modes\n\n### Mode 1: Single Master E2E Flow\n- **Tool**: `nexus_generate_e2e` / CLI `npx nexus-mcp run .`\n- **Output**: Single `.nexus/e2e_flow.md` file exported as `documentation.docx`.\n- **Use Case**: Extracts a single Master Mermaid E2E Flowchart covering the system end-to-end.\n\n### Mode 2: Capability Module Deep-Dives\n- **Tool**: `nexus_plan` + `nexus_save_module_doc`\n- **Output**: Per-module specifications (`.nexus/technical/*.md` & `.nexus/business/*.md`).\n- **Use Case**: Architectural & business rules deep-dives for individual domain modules.\n\n---\n\n## CLI Usage\n\n```bash\n# Index target repository\nnpx nexus-mcp init /path/to/target-repo\n\n# Launch Interactive Web Graph Studio (http://localhost:3333)\nnpx nexus-mcp ui /path/to/target-repo\n\n# Generate execution plan\nnpx nexus-mcp plan /path/to/target-repo\n\n# Run full workflow\nnpx nexus-mcp run /path/to/target-repo\n\n# Export package to Word (.docx)\nnpx nexus-mcp export /path/to/target-repo --format docx --out ./export\n\n# Export package to Docusaurus site\nnpx nexus-mcp export /path/to/target-repo --format docusaurus --out ./docs-site\n```\n\n---\n\n## MCP Tools Reference\n\n| Tool | Description |\n|---|---|\n| `nexus_generate_e2e` | Primary single-step tool. Generates Master E2E Mermaid Flowchart and `.nexus/e2e_flow.md`. |\n| `nexus_plan` | Analyzes AST Knowledge Graph and returns module execution tasks. |\n| `nexus_get_module_context` | Returns source code context for a module task. |\n| `nexus_save_module_doc` | Saves technical & business markdown files for a module. |\n| `nexus_finalize` | Finalizes `.nexus` package and writes `metadata.json`. |\n| `nexus_export` | Exports package to Word (`docx`) or Docusaurus. |\n\n---\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}