mcp-stitch 0.1.0 → 0.1.1
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/LICENSE +15 -0
- package/README.md +49 -0
- package/package.json +12 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
ISC License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Jason McAlpin
|
|
4
|
+
|
|
5
|
+
Permission to use, copy, modify, and/or distribute this software for any
|
|
6
|
+
purpose with or without fee is hereby granted, provided that the above
|
|
7
|
+
copyright notice and this permission notice appear in all copies.
|
|
8
|
+
|
|
9
|
+
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
10
|
+
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
11
|
+
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
12
|
+
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
13
|
+
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
14
|
+
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
15
|
+
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
package/README.md
CHANGED
|
@@ -2,11 +2,32 @@
|
|
|
2
2
|
|
|
3
3
|
MCP server for Google Stitch. It exposes Stitch project, screen, design-system, generation, edit, variant, and artifact export tools over stdio for VS Code and other MCP-compatible agents.
|
|
4
4
|
|
|
5
|
+
## Links
|
|
6
|
+
|
|
7
|
+
- npm: https://www.npmjs.com/package/mcp-stitch
|
|
8
|
+
- GitHub: https://github.com/jasonmcalpin/mcp-stitch
|
|
9
|
+
- Google Stitch: https://stitch.withgoogle.com/
|
|
10
|
+
- Model Context Protocol: https://modelcontextprotocol.io/
|
|
11
|
+
|
|
12
|
+
## Status
|
|
13
|
+
|
|
14
|
+
Early public release. The server is usable, but the Stitch API surface may evolve.
|
|
15
|
+
|
|
5
16
|
## Requirements
|
|
6
17
|
|
|
7
18
|
- Node.js 20 or newer
|
|
8
19
|
- A Google API key with access to Stitch
|
|
9
20
|
|
|
21
|
+
## Install
|
|
22
|
+
|
|
23
|
+
Most MCP clients can run this package with `npx`:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npx -y mcp-stitch
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
You normally do not run that command directly in a terminal. Add it to your MCP client configuration as shown below.
|
|
30
|
+
|
|
10
31
|
## Environment
|
|
11
32
|
|
|
12
33
|
Required:
|
|
@@ -103,6 +124,15 @@ After VS Code starts the server, ask your agent to call `stitch_status` to confi
|
|
|
103
124
|
|
|
104
125
|
Mutating tools require `confirm: true`.
|
|
105
126
|
|
|
127
|
+
## Safety
|
|
128
|
+
|
|
129
|
+
- Secrets are read from environment variables and are not printed by `stitch_status`.
|
|
130
|
+
- `STITCH_API_BASE_URL` defaults to Google's Stitch MCP endpoint.
|
|
131
|
+
- Artifact export paths are constrained to `PROJECT_ROOT` or `STITCH_OUTPUT_DIR`.
|
|
132
|
+
- Mutating Stitch tools require `confirm: true`.
|
|
133
|
+
|
|
134
|
+
Do not commit `.env`, generated artifact bundles, or Stitch output directories. This repo's `.gitignore` excludes the common local output paths.
|
|
135
|
+
|
|
106
136
|
## Development
|
|
107
137
|
|
|
108
138
|
```bash
|
|
@@ -111,6 +141,25 @@ npm run build
|
|
|
111
141
|
npm run dev
|
|
112
142
|
```
|
|
113
143
|
|
|
144
|
+
## Contributing
|
|
145
|
+
|
|
146
|
+
Issues and pull requests are welcome. Please keep changes focused on the Stitch MCP server surface, avoid committing generated Stitch artifacts, and run:
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
npm run build
|
|
150
|
+
npm pack --dry-run
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
before opening a pull request.
|
|
154
|
+
|
|
155
|
+
## Security
|
|
156
|
+
|
|
157
|
+
Please do not open public issues containing API keys, private project IDs, exported Stitch payloads, or other sensitive data. If a report requires private details, open a minimal issue first and note that you need a private disclosure path.
|
|
158
|
+
|
|
159
|
+
## License
|
|
160
|
+
|
|
161
|
+
ISC. See [LICENSE](LICENSE).
|
|
162
|
+
|
|
114
163
|
## Publishing Checklist
|
|
115
164
|
|
|
116
165
|
```bash
|
package/package.json
CHANGED
|
@@ -1,15 +1,24 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-stitch",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "MCP server for Google Stitch.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"mcp-stitch": "./dist/index.js"
|
|
8
8
|
},
|
|
9
|
+
"homepage": "https://github.com/jasonmcalpin/mcp-stitch#readme",
|
|
10
|
+
"repository": {
|
|
11
|
+
"type": "git",
|
|
12
|
+
"url": "git+https://github.com/jasonmcalpin/mcp-stitch.git"
|
|
13
|
+
},
|
|
14
|
+
"bugs": {
|
|
15
|
+
"url": "https://github.com/jasonmcalpin/mcp-stitch/issues"
|
|
16
|
+
},
|
|
9
17
|
"files": [
|
|
10
18
|
"dist",
|
|
11
19
|
"docs/stitch-tools.md",
|
|
12
|
-
"README.md"
|
|
20
|
+
"README.md",
|
|
21
|
+
"LICENSE"
|
|
13
22
|
],
|
|
14
23
|
"scripts": {
|
|
15
24
|
"dev": "tsx src/index.ts",
|
|
@@ -24,7 +33,7 @@
|
|
|
24
33
|
"google-stitch",
|
|
25
34
|
"vscode"
|
|
26
35
|
],
|
|
27
|
-
"author": "",
|
|
36
|
+
"author": "Jason McAlpin",
|
|
28
37
|
"license": "ISC",
|
|
29
38
|
"type": "module",
|
|
30
39
|
"dependencies": {
|