Stitch Server

npm version npm downloads License: MIT Node.js Version CI

Enterprise-ready Model Context Protocol (MCP) server for Google Stitch SDK — Generate beautiful web UIs from text prompts using AI.

The Stitch MCP Server bridges your AI coding assistant (Claude, Cursor, Cline, Copilot, etc.) with Google's Stitch UI Generation API. Design, generate, and scaffold production-ready HTML components directly into your workspace using natural language.

Features

Quick Start

Prerequisites

• Node.js 18.0.0 or higher
• Stitch API Key — Get one here (sign in with Google)

Installation (30 seconds)

Run the interactive setup wizard:

npx stitch-mcp-server setup

This will:

1. Ask which AI tools you want to configure (Claude, Cursor, Cline)
2. Prompt for your Stitch API key
3. Automatically update your MCP configuration files
4. Done - restart your AI tool and start generating UIs

Manual Configuration

If you prefer manual setup, add this to your MCP config file:

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["-y", "stitch-mcp-server@latest"],
      "env": {
        "STITCH_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["-y", "stitch-mcp-server@latest"],
      "env": {
        "STITCH_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "stitch": {
      "command": "npx",
      "args": ["-y", "stitch-mcp-server@latest"],
      "env": {
        "STITCH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

Core Tools

Advanced Tools

Resources

• stitch://projects — List all projects as context
• stitch://projects/{id}/screens — List screens in a project

Prompts

• create_web_app — Guided workflow to build a complete web app from idea to scaffolded files

Usage Examples

Generate a Landing Page

Create a modern landing page for a SaaS product with:
- Hero section with headline and CTA button
- Features grid with 3 columns
- Testimonials carousel
- Footer with links

Create a Dashboard

Generate an admin dashboard with:
- Sidebar navigation
- Stats cards at the top
- Data table with pagination
- Dark mode theme

Edit an Existing Design

Take the login screen and:
- Add social login buttons (Google, GitHub)
- Make it mobile responsive
- Add a "Remember me" checkbox

Local Development

# Clone the repo
git clone https://github.com/0x-Professor/Stitch-mcp-server.git
cd Stitch-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
STITCH_API_KEY=your-key npm start

Running Tests

STITCH_API_KEY=your-key npm test

Tech Stack

• Runtime: Node.js 18+
• Language: TypeScript
• MCP SDK: @modelcontextprotocol/sdk
• Stitch SDK: @google/stitch-sdk
• Validation: Zod
• Build: tsup
• Testing: Vitest

Security

This server implements several security measures:

• Path Traversal Protection — Prevents writing files outside your workspace
• Input Validation — All inputs validated with Zod schemas
• Secure Config Storage — API keys stored with restricted file permissions (0600)
• HTTP Response Validation — Proper error handling for all network requests

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT - 0x-Professor

Links

• npm: npmjs.com/package/stitch-mcp-server
• GitHub: github.com/0x-Professor/Stitch-mcp-server
• Issues: Report a bug
• Stitch SDK: github.com/AugmentedCode/stitch-sdk
• MCP Protocol: modelcontextprotocol.io

_{Built for the AI-assisted development community}