@useconstructor/mcp 1.0.1 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +85 -0
- package/package.json +1 -1
- package/src/mcp/server-stdio.ts +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Constructor MCP
|
|
2
|
+
|
|
3
|
+
Build and deploy full web apps from natural language — directly from Claude Code or any MCP-compatible AI client.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
"create a SaaS landing page with pricing and a waitlist form"
|
|
7
|
+
→ live URL + screenshots in ~3 minutes
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## What it does
|
|
11
|
+
|
|
12
|
+
Constructor takes a prompt and returns a **deployed production URL**. No config, no scaffolding, no manual deploys. Each app gets its own GitHub repo, Vercel deployment, and (optionally) a Turso database.
|
|
13
|
+
|
|
14
|
+
Available tools once connected:
|
|
15
|
+
|
|
16
|
+
| Tool | What it does |
|
|
17
|
+
|---|---|
|
|
18
|
+
| `create_job` | Build a new app from a prompt |
|
|
19
|
+
| `get_job` | Check build progress |
|
|
20
|
+
| `get_project` | Get the live URL, screenshots, cost |
|
|
21
|
+
| `list_projects` | List all your projects |
|
|
22
|
+
| `list_jobs` | Job history for a project |
|
|
23
|
+
| `create_project` | Create a project without building yet |
|
|
24
|
+
| `respond_input` | Answer a clarifying question mid-build |
|
|
25
|
+
|
|
26
|
+
## Setup
|
|
27
|
+
|
|
28
|
+
### 1. Get an API key
|
|
29
|
+
|
|
30
|
+
Sign up at [useconstructor.com](https://www.useconstructor.com) → Settings → Generate API key.
|
|
31
|
+
|
|
32
|
+
### 2. Install
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npm install -g @useconstructor/mcp
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### 3. Add to `~/.claude.json`
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"mcpServers": {
|
|
43
|
+
"construct": {
|
|
44
|
+
"type": "stdio",
|
|
45
|
+
"command": "constructor-mcp",
|
|
46
|
+
"env": {
|
|
47
|
+
"CONSTRUCTOR_API_KEY": "csk_your_key_here"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### 4. Restart Claude Code
|
|
55
|
+
|
|
56
|
+
Run `/mcp` to verify `construct` appears as connected.
|
|
57
|
+
|
|
58
|
+
## Usage
|
|
59
|
+
|
|
60
|
+
Just describe what you want to build:
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
Build a portfolio site for a photographer. Dark theme, minimal, with a gallery grid and contact form.
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
Create a SaaS dashboard with a sidebar nav, usage charts, and a settings page.
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
Make a restaurant website for "La Cocina" — warm colors, menu page, reservation form.
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Constructor handles the rest: plans the design, writes the code, deploys to Vercel, and returns screenshots.
|
|
75
|
+
|
|
76
|
+
## Requirements
|
|
77
|
+
|
|
78
|
+
- Node.js 18+
|
|
79
|
+
- An active Constructor account (activate at [useconstructor.com/app/settings](https://www.useconstructor.com/app/settings))
|
|
80
|
+
|
|
81
|
+
## Links
|
|
82
|
+
|
|
83
|
+
- [Constructor](https://www.useconstructor.com) — platform homepage
|
|
84
|
+
- [Settings & API key](https://www.useconstructor.com/app/settings) — generate your key
|
|
85
|
+
- [REST API docs](https://constructor-api-prod.vercel.app/health) — use Constructor without MCP
|
package/package.json
CHANGED
package/src/mcp/server-stdio.ts
CHANGED
|
@@ -10,7 +10,7 @@ import {
|
|
|
10
10
|
ListToolsRequestSchema,
|
|
11
11
|
} from '@modelcontextprotocol/sdk/types.js';
|
|
12
12
|
|
|
13
|
-
const API_BASE = process.env.CONSTRUCTOR_API_URL || '
|
|
13
|
+
const API_BASE = process.env.CONSTRUCTOR_API_URL || 'https://api.useconstructor.com';
|
|
14
14
|
const API_KEY = process.env.CONSTRUCTOR_API_KEY || '';
|
|
15
15
|
|
|
16
16
|
if (!API_KEY) {
|