@_davideast/stitch-mcp 0.0.5 → 0.1.0

package/README.md

@@ -1,15 +1,8 @@
 # Stitch MCP Helper CLI
 
-> Stitch MCP OAuth setup assistant - automates Google Cloud authentication for Stitch API
+> A guided checklist and proxy server for the Stitch MCP
 
-## One command to connect any MCP client to Stitch
-
-`npx @_davideast/stitch-mcp init` walks you through the complete Google Cloud authentication setup for Stitch API in a single interactive session. It guides you through installing `gcloud`, configuring authentication, managing IAM permissions, enabling APIs, and generating your client-specific MCP config.
-
-- **Zero Config Setup:** One `npx` command handles gcloud install, authentication, project setup, and MCP configuration
-- **Universal Client Support:** Works with Antigravity, Claude Code, Cursor, VSCode, or Gemini CLI
-- **Smart Defaults:** Automatically detects existing gcloud installations and reuses active projects
-- **Self-Healing:** Built-in `doctor` command diagnoses and reports setup issues
+![Example usage](/assets/splash.png)
 
 ## Quick Start
 
@@ -86,6 +79,46 @@ Setup Complete! ✔
 
 Copy this config into your MCP client settings and you're ready to use the Stitch MCP server.
 
+## Quick Start (Existing gcloud Users)
+
+If you already have `gcloud` configured, skip `init` and use the proxy directly.
+
+**Prerequisites:**
+```bash
+# 1. Application Default Credentials
+gcloud auth application-default login
+
+# 2. Set project (if not already set)
+gcloud config set project <PROJECT_ID>
+
+# 3. Enable Stitch API (requires beta component)
+gcloud components install beta
+gcloud beta services mcp enable stitch.googleapis.com --project=<PROJECT_ID>
+```
+
+**MCP Configuration:**
+```json
+{
+  "mcpServers": {
+    "stitch": {
+      "command": "npx",
+      "args": ["@_davideast/stitch-mcp", "proxy"],
+      "env": {
+        "STITCH_USE_SYSTEM_GCLOUD": "1"
+      }
+    }
+  }
+}
+```
+
+**Environment Variables:**
+| Variable | Description |
+|----------|-------------|
+| `STITCH_USE_SYSTEM_GCLOUD` | Use system gcloud config instead of isolated config |
+| `STITCH_PROJECT_ID` | Override project ID |
+| `GOOGLE_CLOUD_PROJECT` | Alternative project ID variable |
+| `STITCH_HOST` | Custom Stitch API endpoint |
+
 ## Verify Your Setup
 
 ```bash
@@ -139,7 +172,7 @@ npx @_davideast/stitch-mcp init [options]
 **Options:**
 - `--local` - Install gcloud locally to project instead of user home
 - `-y, --yes` - Auto-approve verification prompts (skips "Check your current setup status?")
-- `-c, --client <client>` - Specify MCP client (antigravity, vscode, cursor, claude-code, gemini-cli)
+- `-c, --client <client>` - Specify MCP client (antigravity, vscode, cursor, claude-code, gemini-cli, opencode)
 - `-t, --transport <type>` - Transport type (http or stdio)
 
 **What happens:**
@@ -184,6 +217,21 @@ Revokes both user authentication and Application Default Credentials. Useful for
 - Clearing authentication for testing
 - Resetting state when troubleshooting
 
+#### `view` - View Stitch Resources
+
+```bash
+npx @_davideast/stitch-mcp view [options]
+```
+
+**Options:**
+- `--projects` - List all projects
+- `--name <name>` - Resource name to view
+- `--sourceScreen <name>` - Source screen resource name
+- `--project <id>` - Project ID
+- `--screen <id>` - Screen ID
+
+Interactively view Stitch resources such as projects and screens. Displays the resource data in a JSON tree format.
+
 #### `proxy` - MCP Proxy Server
 
 ```bash