@donotdev/mcp-server 0.0.1

package/README.md

@@ -0,0 +1,102 @@
+# DoNotDev MCP Server
+
+MCP server that provides component type lookups from published `.d.ts` files. Prevents AI hallucination by giving access to actual TypeScript definitions.
+
+## Setup
+
+### 1. Build
+
+```bash
+cd packages/mcp-server
+bun install
+bun run build
+```
+
+### 2. Configure Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "donotdev": {
+      "command": "node",
+      "args": ["/absolute/path/to/dndev/packages/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+Or for Claude Desktop, add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "donotdev": {
+      "command": "node",
+      "args": ["/absolute/path/to/dndev/packages/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+### 3. Restart Claude Code
+
+```bash
+claude --mcp-debug
+```
+
+## Tools
+
+### `lookup_component`
+
+Get TypeScript props/types for a component.
+
+```
+Input: { "component": "Button" }
+Output: Full ButtonProps interface from .d.ts
+```
+
+```
+Input: { "component": "EntityFormRenderer", "package": "@donotdev/ui" }
+Output: Full EntityFormRendererProps interface
+```
+
+### `list_components`
+
+List all exports from a package.
+
+```
+Input: { "package": "@donotdev/components" }
+Output: Button, Text, Stack, Card, Grid, Section, Badge, Spinner, ...
+```
+
+### `list_packages`
+
+List all available DoNotDev packages.
+
+```
+Input: {}
+Output: @donotdev/components, @donotdev/ui, @donotdev/core, ...
+```
+
+## How It Works
+
+1. AI calls `lookup_component({ component: "Button" })`
+2. Server reads `node_modules/@donotdev/components/dist/index.d.ts`
+3. Extracts `ButtonProps` interface using regex
+4. Returns actual TypeScript definition
+5. AI sees real props, can't hallucinate
+
+## Usage in CLAUDE.md
+
+Add to your project's CLAUDE.md:
+
+```markdown
+## Component Usage
+
+BEFORE writing any component, call:
+- `lookup_component` to get the actual props
+
+NEVER guess props. If MCP unavailable, ask user.
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview DoNotDev MCP Server
+ * @description Provides component type lookups from published .d.ts files
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import{Server as v}from"@modelcontextprotocol/sdk/server/index.js";import{StdioServerTransport as y}from"@modelcontextprotocol/sdk/server/stdio.js";import{CallToolRequestSchema as k,ListToolsRequestSchema as S}from"@modelcontextprotocol/sdk/types.js";import{readFileSync as f,existsSync as m}from"fs";import{join as a}from"path";const g=["@donotdev/components","@donotdev/adv-comps","@donotdev/core","@donotdev/crud","@donotdev/firebase","@donotdev/auth","@donotdev/billing","@donotdev/oauth","@donotdev/ui","@donotdev/templates","@donotdev/functions","@donotdev/providers"];function w(){let e=process.cwd();for(;e!=="/";){const o=a(e,"node_modules");if(m(o))return o;e=a(e,"..")}return null}function $(e,o){const c=new RegExp(`export\\s+interface\\s+${o}\\s*(?:<[^>]+>)?\\s*(?:extends[^{]+)?\\{[^}]+\\}`,"gs");let n=e.match(c);if(n)return n[0];const s=new RegExp(`export\\s+type\\s+${o}\\s*(?:<[^>]+>)?\\s*=[^;]+;`,"gs");if(n=e.match(s),n)return n[0];const r=new RegExp(`export\\s+const\\s+${o}\\s*[=:][^;]+;`,"gs");return n=e.match(r),n?n[0]:null}function R(e){const o=[],c=e.matchAll(/export\s*\{([^}]+)\}/g);for(const t of c)if(t[1]){const d=t[1].split(",").map(p=>p.trim().split(" ")[0]).filter(p=>!!p);o.push(...d)}const n=e.matchAll(/export\s+interface\s+(\w+)/g);for(const t of n)t[1]&&o.push(t[1]);const s=e.matchAll(/export\s+type\s+(\w+)/g);for(const t of s)t[1]&&o.push(t[1]);const r=e.matchAll(/export\s+const\s+(\w+)/g);for(const t of r)t[1]&&o.push(t[1]);const i=e.matchAll(/export\s+default\s+(\w+)/g);for(const t of i)t[1]&&o.push(t[1]);return[...new Set(o)].filter(t=>t&&t!=="default")}const l=new v({name:"donotdev-mcp",version:"0.0.1"},{capabilities:{tools:{}}});l.setRequestHandler(S,async()=>({tools:[{name:"lookup_component",description:"Get TypeScript props/types for a DoNotDev component. Returns the actual interface from .d.ts files.",inputSchema:{type:"object",properties:{component:{type:"string",description:'Component name (e.g., "Button", "ButtonProps", "Stack", "EntityFormRenderer")'},package:{type:"string",description:'Package name (e.g., "@donotdev/components"). If omitted, searches all packages.'}},required:["component"]}},{name:"list_components",description:"List all exported components/types from a DoNotDev package",inputSchema:{type:"object",properties:{package:{type:"string",description:'Package name (e.g., "@donotdev/components")'}},required:["package"]}},{name:"list_packages",description:"List all DoNotDev packages",inputSchema:{type:"object",properties:{}}}]})),l.setRequestHandler(k,async e=>{const{name:o,arguments:c}=e.params,n=w();if(!n)return{content:[{type:"text",text:"Error: node_modules not found. Run from project directory."}]};if(o==="list_packages")return{content:[{type:"text",text:`Available packages:
+${g.filter(r=>m(a(n,r,"dist","index.d.ts"))).join(`
+`)}`}]};if(o==="list_components"){const s=c?.package,r=a(n,s,"dist","index.d.ts");if(!m(r))return{content:[{type:"text",text:`Error: ${s} not found at ${r}`}]};const i=f(r,"utf-8"),t=R(i);return{content:[{type:"text",text:`Exports from ${s}:
+${t.join(`
+`)}`}]}}if(o==="lookup_component"){const s=c?.component,r=c?.package,i=[s,`${s}Props`,`${s.replace(/Props$/,"")}Props`],t=r?[r]:g;for(const d of t){const p=a(n,d,"dist","index.d.ts");if(!m(p))continue;const x=f(p,"utf-8");for(const h of i){const u=$(x,h);if(u)return{content:[{type:"text",text:`Found in ${d}:
+
+${u}`}]}}}return{content:[{type:"text",text:`Not found: ${s}
+
+Tip: Try lookup_component with just the component name (e.g., "Button" not "ButtonProps"), or use list_components to see available exports.`}]}}return{content:[{type:"text",text:`Unknown tool: ${o}`}]}});async function b(){const e=new y;await l.connect(e)}b().catch(console.error);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@donotdev/mcp-server",
+  "version": "0.0.1",
+  "description": "MCP server for DoNotDev component type lookups",
+  "type": "module",
+  "private": false,
+  "bin": {
+    "@donotdev/mcp-server": "./dist/index.js",
+    "donotdev-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "dn bundle --package @donotdev/mcp-server",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/donotdev/mcp-server.git"
+  },
+  "keywords": [
+    "dndev",
+    "mcp",
+    "model-context-protocol",
+    "typescript",
+    "component-lookup"
+  ],
+  "author": "AMBROISE PARK Consulting",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}