@useconstructor/mcp 1.0.0

package/bin/constructor-mcp.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+const { spawnSync } = require('child_process');
+const path = require('path');
+
+const tsx = path.join(__dirname, '..', 'node_modules', '.bin', 'tsx');
+const server = path.join(__dirname, '..', 'src', 'mcp', 'server-stdio.ts');
+
+const result = spawnSync(tsx, [server], {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@useconstructor/mcp",
+  "version": "1.0.0",
+  "description": "Constructor MCP server — build and deploy web apps from natural language via Claude Code",
+  "main": "index.js",
+  "bin": {
+    "constructor-mcp": "./bin/constructor-mcp.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "db:migrate": "tsx src/db/migrate.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@anthropic-ai/bedrock-sdk": "^0.32.4",
+    "@anthropic-ai/sdk": "^0.55.1",
+    "@libsql/client": "^0.18.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@octokit/rest": "^19.0.13",
+    "@supabase/supabase-js": "^2.112.3",
+    "@types/express": "^5.0.6",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^26.2.0",
+    "@types/pg": "^8.21.0",
+    "@types/uuid": "^10.0.0",
+    "@vercel/functions": "^3.9.5",
+    "@vercel/sandbox": "^3.2.1",
+    "cors": "^2.8.6",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "helmet": "^8.3.0",
+    "jsonwebtoken": "^9.0.3",
+    "libsodium-wrappers": "^0.8.4",
+    "modal": "^0.9.0",
+    "morgan": "^1.11.0",
+    "openai": "^7.5.0",
+    "pg": "^8.23.0",
+    "playwright": "^1.62.1",
+    "stripe": "^22.6.2",
+    "tsx": "^4.23.12",
+    "typescript": "^7.0.2",
+    "uuid": "^11.1.1",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/morgan": "^1.9.10"
+  }
+}

package/src/mcp/server-stdio.ts

@@ -0,0 +1,174 @@
+/**
+ * Constructor MCP server — stdio transport (compatible with Claude Code / Claude Desktop).
+ * Run with: CONSTRUCTOR_API_KEY=csk_... tsx src/mcp/server-stdio.ts
+ * Or configure in Claude Code: claude mcp add constructor ...
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+const API_BASE = process.env.CONSTRUCTOR_API_URL || 'http://localhost:4000';
+const API_KEY = process.env.CONSTRUCTOR_API_KEY || '';
+
+if (!API_KEY) {
+  process.stderr.write('CONSTRUCTOR_API_KEY env var is required\n');
+  process.exit(1);
+}
+
+function auth() {
+  return { Authorization: `Bearer ${API_KEY}`, 'Content-Type': 'application/json' };
+}
+
+const server = new Server(
+  { name: 'construct', version: '1.0.0' },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'create_job',
+      description: 'Create a new Constructor project and start building it from a natural-language prompt. Returns immediately with job_id and project_id.',
+      inputSchema: {
+        type: 'object',
+        required: ['prompt'],
+        properties: {
+          prompt: { type: 'string', description: 'Natural language description of what to build' },
+          project_id: { type: 'string', description: 'Existing project ID to modify (omit for new project)' },
+          project_name: { type: 'string', description: 'Name for the new project' },
+          context: { type: 'string', description: 'Additional business context' },
+          builder_model: { type: 'string', enum: ['modal_claude_code', 'codex'] },
+        },
+      },
+    },
+    {
+      name: 'get_job',
+      description: 'Get the current status and progress of a Constructor job.',
+      inputSchema: {
+        type: 'object',
+        required: ['job_id'],
+        properties: { job_id: { type: 'string' } },
+      },
+    },
+    {
+      name: 'get_project',
+      description: 'Get the state of a Constructor project: production URL, deployments, screenshots, usage.',
+      inputSchema: {
+        type: 'object',
+        required: ['project_id'],
+        properties: { project_id: { type: 'string' } },
+      },
+    },
+    {
+      name: 'respond_input',
+      description: 'Provide an answer when a Constructor job is waiting for user input (needs_input state).',
+      inputSchema: {
+        type: 'object',
+        required: ['job_id', 'answer'],
+        properties: {
+          job_id: { type: 'string' },
+          answer: { type: 'string' },
+        },
+      },
+    },
+    {
+      name: 'list_projects',
+      description: 'List all Constructor projects for the authenticated account.',
+      inputSchema: { type: 'object', required: [], properties: {} },
+    },
+    {
+      name: 'list_jobs',
+      description: 'List jobs for a specific Constructor project.',
+      inputSchema: {
+        type: 'object',
+        required: ['project_id'],
+        properties: { project_id: { type: 'string' } },
+      },
+    },
+    {
+      name: 'create_project',
+      description: 'Create an empty Constructor project without triggering a build. Returns project_id. Pass it to create_job when ready to build.',
+      inputSchema: {
+        type: 'object',
+        required: ['name'],
+        properties: {
+          name: { type: 'string' },
+          description: { type: 'string' },
+        },
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const { name, arguments: args = {} } = req.params;
+
+  try {
+    let result: unknown;
+
+    switch (name) {
+      case 'create_job': {
+        const res = await fetch(`${API_BASE}/v1/jobs`, {
+          method: 'POST',
+          headers: auth(),
+          body: JSON.stringify(args),
+        });
+        result = await res.json();
+        break;
+      }
+      case 'get_job': {
+        const res = await fetch(`${API_BASE}/v1/jobs/${args.job_id}`, { headers: auth() });
+        result = await res.json();
+        break;
+      }
+      case 'get_project': {
+        const res = await fetch(`${API_BASE}/v1/projects/${args.project_id}`, { headers: auth() });
+        result = await res.json();
+        break;
+      }
+      case 'respond_input': {
+        const res = await fetch(`${API_BASE}/v1/jobs/${args.job_id}/input`, {
+          method: 'POST',
+          headers: auth(),
+          body: JSON.stringify({ answer: args.answer }),
+        });
+        result = await res.json();
+        break;
+      }
+      case 'list_projects': {
+        const res = await fetch(`${API_BASE}/v1/projects`, { headers: auth() });
+        result = await res.json();
+        break;
+      }
+      case 'list_jobs': {
+        const res = await fetch(`${API_BASE}/v1/projects/${args.project_id}/jobs`, { headers: auth() });
+        result = await res.json();
+        break;
+      }
+      case 'create_project': {
+        const res = await fetch(`${API_BASE}/v1/projects`, {
+          method: 'POST',
+          headers: auth(),
+          body: JSON.stringify(args),
+        });
+        result = await res.json();
+        break;
+      }
+      default:
+        return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
+    }
+
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+  } catch (err: any) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+server.connect(transport).catch((err) => {
+  process.stderr.write(`MCP server error: ${err.message}\n`);
+  process.exit(1);
+});