{"_id":"3d-db-mcp-zq","_rev":"5-57444e5f4c056f5fe4ffe9afa0398f94","name":"3d-db-mcp-zq","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"3d-db-mcp-zq","version":"0.1.0","_id":"3d-db-mcp-zq@0.1.0","maintainers":[{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"}],"bin":{"db-viz-mcp":"dist/index.js"},"dist":{"shasum":"5f82e8ce59a05dbf4dcdf618f6b535c8e8beb0af","tarball":"https://registry.npmjs.org/3d-db-mcp-zq/-/3d-db-mcp-zq-0.1.0.tgz","fileCount":19,"integrity":"sha512-XUrdo9xrpS1PMClGSOBc5J2UaF0qE4dDLnDoWX3LG+eqHu8U9JErHp+W5+zaIGEhMToAu+4thyOtqQpVVI5C9Q==","signatures":[{"sig":"MEYCIQDB/9W4ZAuZxAxM0ACgKTQ4gXwSLFi/haIe35ORhaRaZAIhALG1zRWP2tJhOlD/elRp4CBqKnDR5TJVK8mBflVRpFxu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4152157},"type":"module","engines":{"node":">=18"},"gitHead":"0e5cd2a228e7976883de51d8cd37c9e554d1446d","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc"},"_npmUser":{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"},"_npmVersion":"11.6.2","description":"MCP server for 3d-db — visualize your database in 3D from Claude, Cursor, Windsurf, or any MCP client","directories":{},"_nodeVersion":"25.6.0","dependencies":{"ws":"^8.18.0","open":"^10.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","@types/ws":"^8.5.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/3d-db-mcp-zq_0.1.0_1777058550425_0.30414785660634114","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"3d-db-mcp-zq","version":"0.1.1","license":"MIT","_id":"3d-db-mcp-zq@0.1.1","maintainers":[{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"}],"bin":{"db-viz-mcp":"dist/index.js"},"dist":{"shasum":"182fd2c04085571617ca7bda0d15e50554fad90f","tarball":"https://registry.npmjs.org/3d-db-mcp-zq/-/3d-db-mcp-zq-0.1.1.tgz","fileCount":19,"integrity":"sha512-+C6uK0SERaWDHcx6Kf7si6ObkVh1504AEznXghLUoSMKKIui3S3PW3RUWS4xZVFhkPdGKi5oOgR6p9N8PFFCMQ==","signatures":[{"sig":"MEUCIQDzDaHW3BL8snMfAZSyflxM789kd8bl+i8je0RpUypwVAIgaB0ksrX5GOXr6HckdNFGydkanVt/U+6diEPRI5cVz5w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4152177},"type":"module","engines":{"node":">=18"},"gitHead":"0e5cd2a228e7976883de51d8cd37c9e554d1446d","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc"},"_npmUser":{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"},"_npmVersion":"11.6.2","description":"MCP server for 3d-db — visualize your database in 3D from Claude, Cursor, Windsurf, or any MCP client","directories":{},"_nodeVersion":"25.6.0","dependencies":{"ws":"^8.18.0","open":"^10.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","@types/ws":"^8.5.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/3d-db-mcp-zq_0.1.1_1777058720443_0.9828677559313501","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"3d-db-mcp-zq","version":"0.1.2","license":"MIT","_id":"3d-db-mcp-zq@0.1.2","maintainers":[{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"}],"bin":{"db-viz-mcp":"dist/index.js"},"dist":{"shasum":"089ab914af088ec2f3f234fa5871d15ba02fc0da","tarball":"https://registry.npmjs.org/3d-db-mcp-zq/-/3d-db-mcp-zq-0.1.2.tgz","fileCount":20,"integrity":"sha512-hbinTdbECBXQPaTqMOfImXXy1iqpmjWp5Fa1miGeHyOeLIHqL7/iWY68eA2EthiKONe0mH3+bIo+eMGEhBZNQA==","signatures":[{"sig":"MEUCIFFe3Lf9j7JRl0DjMK5SolxZhvUGOovXVF7KRQ8IpHJmAiEAgZyqoxhvLJnVGYbK8AK5HoXMxG6os+ejjE0TA+10q04=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4155403},"type":"module","engines":{"node":">=18"},"gitHead":"0e5cd2a228e7976883de51d8cd37c9e554d1446d","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc"},"_npmUser":{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"},"_npmVersion":"11.6.2","description":"MCP server for 3d-db — visualize your database in 3D from Claude, Cursor, Windsurf, or any MCP client","directories":{},"_nodeVersion":"25.6.0","dependencies":{"ws":"^8.18.0","open":"^10.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","@types/ws":"^8.5.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/3d-db-mcp-zq_0.1.2_1777059459205_0.8039421073482282","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"3d-db-mcp-zq","version":"0.1.3","license":"MIT","_id":"3d-db-mcp-zq@0.1.3","maintainers":[{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"}],"bin":{"db-viz-mcp":"dist/index.js"},"dist":{"shasum":"41c96b96a7c3e3fbf7fdf514c7c37deea2bc92eb","tarball":"https://registry.npmjs.org/3d-db-mcp-zq/-/3d-db-mcp-zq-0.1.3.tgz","fileCount":20,"integrity":"sha512-Xvcf3D05SOJv9p6UknqXKDJ6d5AkHV1BU4i7XRz5Tm/6mcPewEzGAf0N2nhbvS0rcS06IEmLO0epJyY0XfTepQ==","signatures":[{"sig":"MEYCIQD45KIdpVpRViFlH6hcGoGoXDQYtrtyjLaSkRlnISlAWwIhAMZnfzHLgLmgKTVO4v8Zh4Wz1S8yIzWr+z+abRHECM0D","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4155246},"type":"module","engines":{"node":">=18"},"gitHead":"0e5cd2a228e7976883de51d8cd37c9e554d1446d","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc"},"_npmUser":{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"},"_npmVersion":"11.6.2","description":"MCP server for 3d-db — visualize your database in 3D from Claude, Cursor, Windsurf, or any MCP client","directories":{},"_nodeVersion":"25.6.0","dependencies":{"ws":"^8.18.0","open":"^10.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","@types/ws":"^8.5.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/3d-db-mcp-zq_0.1.3_1777059798703_0.9086823370812243","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"3d-db-mcp-zq","version":"0.1.4","license":"MIT","description":"MCP server for 3d-db — visualize your database in 3D from Claude, Cursor, Windsurf, or any MCP client","type":"module","bin":{"db-viz-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","test":"vitest run","dev":"tsx src/index.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","open":"^10.1.0","ws":"^8.18.0"},"devDependencies":{"@types/node":"^22.0.0","@types/ws":"^8.5.0","tsx":"^4.19.0","typescript":"^5.6.0","vitest":"^3.0.0"},"gitHead":"0e5cd2a228e7976883de51d8cd37c9e554d1446d","_id":"3d-db-mcp-zq@0.1.4","_nodeVersion":"25.6.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-PREdN/NHgIo06SafrgpeFXnzd6/i0qOHbGw1NfhiAdNSc0+iU4TQY99lOgtoXtDT65VAQ2dtR1eoD0pTR59fHA==","shasum":"1ca90d21b7ff16287ca2d5baf58460025ab8cea9","tarball":"https://registry.npmjs.org/3d-db-mcp-zq/-/3d-db-mcp-zq-0.1.4.tgz","fileCount":20,"unpackedSize":4155692,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC376v3nHbC47gLFcZYmDlYlvvB9CUmW8PO7gfzc1RPOgIhAORQGUBC9Zjnm3nq+RR42quC7LxLLSTV6O09JfeYfOuf"}]},"_npmUser":{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"},"directories":{},"maintainers":[{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/3d-db-mcp-zq_0.1.4_1777061450396_0.9935162187245039"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T19:22:30.305Z","modified":"2026-04-24T20:10:50.718Z","0.1.0":"2026-04-24T19:22:30.670Z","0.1.1":"2026-04-24T19:25:20.637Z","0.1.2":"2026-04-24T19:37:39.419Z","0.1.3":"2026-04-24T19:43:18.970Z","0.1.4":"2026-04-24T20:10:50.605Z"},"license":"MIT","description":"MCP server for 3d-db — visualize your database in 3D from Claude, Cursor, Windsurf, or any MCP client","maintainers":[{"name":"zaidqourah2004","email":"qourahzaid@gmail.com"}],"readme":"# 3d-db MCP Server\n\nLets AI tools (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code with GitHub Copilot/Cline/Continue) visualize your database schema in 3D — automatically, on command.\n\n**You do not need to clone any repository or run a dev server.** The visualizer is bundled inside this package. The only requirement is Node.js.\n\n---\n\n## Requirements\n\n- **Node.js 18 or later** — check with `node --version`. Download from [nodejs.org](https://nodejs.org) if needed.\n- One of: **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, or **VS Code** (with GitHub Copilot, Cline, or Continue).\n- Your AI tool already connected to your database. This tool handles **visualization only** — it does not connect to your database directly.\n\n---\n\n## Setup\n\nRun this once in your terminal:\n\n```\nnpx --yes --package 3d-db-mcp-zq db-viz-mcp setup\n```\n\nThis detects which AI tools you have installed and configures them automatically. No config files to edit.\n\nThen **restart your AI tool** and ask it:\n\n> \"Load my database schema into the 3D visualizer\"\n\nA browser window opens with your schema in 3D.\n\n---\n\n## VS Code (GitHub Copilot, Cline, Continue)\n\nVS Code MCP config is project-scoped. Add `.vscode/mcp.json` to your project:\n\n```json\n{\n  \"servers\": {\n    \"3d-db\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"--yes\", \"--package\", \"3d-db-mcp-zq\", \"db-viz-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## What your AI can do\n\n### `load_schema`\n\nLoads your database schema into the 3D visualizer. Accepts JSON or SQL DDL.\n\n**Example prompt:**\n> \"Load my database schema into the 3D visualizer\"\n\n### `highlight_query`\n\nHighlights a SQL query — dims unrelated tables, draws the join path.\n\n**Example prompt:**\n> \"Show me how this query touches the database\"\n\n### `get_schema`\n\nReads the current schema back from the visualizer, including tables, relationships, row counts, and optimization tips.\n\n**Example prompt:**\n> \"What does my schema look like right now? Any issues?\"\n\n---\n\n## How it works\n\nThe setup command patches your AI tool's config file to add:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"--yes\", \"--package\", \"3d-db-mcp-zq\", \"db-viz-mcp\"]\n}\n```\n\nWhen your AI tool starts a session, it runs this command automatically. The server:\n\n1. Picks an available port (starting at 4242)\n2. Generates a one-time session token\n3. Opens your browser at `http://localhost:<port>?token=<token>`\n4. Serves the 3D visualizer as a local web page\n5. Listens for tool calls from your AI\n\nThe server shuts down automatically when your AI session ends.\n\n---\n\n## Security\n\n- Runs on `localhost` only — never exposed to the network\n- A random token is generated each session — no other tab or process can connect\n- No database credentials are stored or proxied — your AI tool handles the database connection\n- The server shuts down automatically when your AI tool session ends\n","readmeFilename":"README.md"}