@polymorphism-tech/morph-spec 4.21.0 → 5.0.1

package/framework/{skills/level-0-meta/mcp-registry.json → mcp/registry.json}

@@ -1,210 +1,254 @@
-{
-  "version": "4.0.0",
-  "description": "Centralized MCP registry with phase relevance and install configuration for morph-spec workflows",
-  "mcps": {
-    "context7": {
-      "phases": ["proposal", "design", "tasks", "implement"],
-      "tools": ["resolve-library-id", "query-docs"],
-      "detection": "enabledPlugins includes context7 or mcpServers includes context7",
-      "fallback": "WebSearch + WebFetch for library documentation",
-      "usage": "Library documentation lookups, API reference, implementation patterns",
-      "healthCheck": {
-        "toolPattern": "context7",
-        "testCall": "Call resolve-library-id with libraryName 'react' and query 'react hooks'",
-        "testParams": { "libraryName": "react", "query": "react hooks" },
-        "successIndicator": "Returns a library ID (e.g., /facebook/react)",
-        "failureHint": "Context7 MCP not responding. Check that @upstash/context7-mcp is installed and the MCP server is running. Try restarting Claude Code."
-      },
-      "install": {
-        "autoInstall": true,
-        "transport": "stdio",
-        "config": {
-          "command": "cmd",
-          "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"]
-        },
-        "credentials": [],
-        "prerequisites": [],
-        "stackRelevance": ["*"],
-        "warnings": [],
-        "setupGuide": null
-      }
-    },
-    "playwright": {
-      "phases": ["uiux", "implement"],
-      "tools": ["browser_navigate", "browser_snapshot", "browser_take_screenshot", "browser_console_messages", "browser_click", "browser_resize"],
-      "detection": "mcpServers includes playwright",
-      "fallback": "WebFetch for read-only page content, manual testing",
-      "usage": "UI preview, smoke testing, page inspection, responsive testing, screenshot capture",
-      "healthCheck": {
-        "toolPattern": "playwright",
-        "testCall": "Call browser_navigate with url 'about:blank'",
-        "testParams": { "url": "about:blank" },
-        "successIndicator": "Page navigates successfully (no error thrown)",
-        "failureHint": "Playwright MCP not responding. Ensure @playwright/mcp is installed and browser binaries are available. Run 'npx playwright install' if needed."
-      },
-      "install": {
-        "autoInstall": true,
-        "transport": "stdio",
-        "config": {
-          "command": "cmd",
-          "args": ["/c", "npx", "-y", "@playwright/mcp@latest"]
-        },
-        "credentials": [],
-        "prerequisites": [],
-        "stackRelevance": ["*"],
-        "warnings": [],
-        "setupGuide": null
-      }
-    },
-    "github": {
-      "phases": ["tasks", "implement"],
-      "tools": ["get_repo", "search_code", "create_issue", "create_pull_request", "search_issues"],
-      "detection": "mcpServers includes github",
-      "fallback": "Bash `gh` CLI commands",
-      "usage": "Repo metadata, code search, issue creation, PR management",
-      "healthCheck": {
-        "toolPattern": "github",
-        "testCall": "Call any read-only GitHub tool (e.g., search_repositories or get_repo) to verify connectivity",
-        "testParams": {},
-        "successIndicator": "Returns repository data or search results without auth errors",
-        "failureHint": "GitHub MCP not responding. If using Docker, ensure Docker Desktop is running. Verify GITHUB_PERSONAL_ACCESS_TOKEN env var is set. Ensure the token has not expired and has the required scopes (repo, read:org)."
-      },
-      "install": {
-        "autoInstall": false,
-        "transport": "stdio",
-        "config": {
-          "command": "docker",
-          "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
-          "env": {
-            "GITHUB_PERSONAL_ACCESS_TOKEN": ""
-          }
-        },
-        "credentials": [
-          {
-            "name": "GitHub Personal Access Token",
-            "envVar": "GITHUB_PERSONAL_ACCESS_TOKEN",
-            "secret": true,
-            "helpUrl": "https://github.com/settings/tokens"
-          }
-        ],
-        "prerequisites": [
-          {
-            "name": "Docker",
-            "checkCommand": "docker --version",
-            "installUrl": "https://docs.docker.com/get-docker/"
-          }
-        ],
-        "stackRelevance": ["*"],
-        "warnings": [],
-        "setupGuide": "Official GitHub MCP Server (github/github-mcp-server). Requires Docker."
-      }
-    },
-    "vercel": {
-      "phases": ["implement"],
-      "tools": ["search_docs", "list_projects", "get_deployments", "get_deployment_logs", "manage_env_vars"],
-      "detection": "mcpServers includes vercel",
-      "fallback": "Bash `vercel` CLI commands",
-      "usage": "Deployment monitoring, project management, environment variables, log analysis",
-      "healthCheck": {
-        "toolPattern": "vercel",
-        "testCall": "Call search_docs with a query to verify connectivity",
-        "testParams": { "query": "deployments" },
-        "successIndicator": "Returns documentation search results without auth errors",
-        "failureHint": "Vercel MCP not responding. Re-authenticate via /mcp in Claude Code. Ensure you have authorized the Vercel OAuth connection."
-      },
-      "install": {
-        "autoInstall": false,
-        "transport": "http",
-        "config": {
-          "type": "http",
-          "url": "https://mcp.vercel.com"
-        },
-        "credentials": [],
-        "prerequisites": [],
-        "stackRelevance": ["nextjs", "nextjs-neon", "vercel"],
-        "warnings": ["Uses OAuth — you will be prompted to authenticate via browser when first connecting."],
-        "setupGuide": "Run: claude mcp add --transport http vercel https://mcp.vercel.com"
-      }
-    },
-    "asaas": {
-      "phases": ["design", "implement"],
-      "tools": ["enumerate_endpoints", "get_endpoint_schema", "generate_code_example", "execute_api_call", "search_docs"],
-      "detection": "mcpServers includes asaas",
-      "fallback": "WebFetch https://docs.asaas.com for API documentation",
-      "usage": "Asaas payment API docs, endpoint schemas, code examples, direct API calls",
-      "healthCheck": {
-        "toolPattern": "asaas",
-        "testCall": "Search Asaas docs for 'payments' to verify connectivity",
-        "testParams": { "query": "payments" },
-        "successIndicator": "Returns documentation results about payment endpoints",
-        "failureHint": "Asaas MCP not responding. Verify the MCP is configured with url: https://docs.asaas.com/mcp"
-      },
-      "install": {
-        "autoInstall": false,
-        "transport": "http",
-        "config": {
-          "type": "http",
-          "url": "https://docs.asaas.com/mcp"
-        },
-        "credentials": [],
-        "prerequisites": [],
-        "stackRelevance": ["asaas"],
-        "warnings": ["API call execution requires your Asaas access_token. Doc search works without authentication."],
-        "setupGuide": "Run: claude mcp add --transport http asaas https://docs.asaas.com/mcp"
-      }
-    },
-    "stitch": {
-      "phases": ["uiux"],
-      "tools": ["create_project", "list_projects", "get_project", "list_screens", "get_screen", "generate_screen_from_text", "fetch_screen_code", "fetch_screen_image"],
-      "detection": "mcpServers includes stitch",
-      "fallback": "HTML mockup + Playwright screenshots (Step 3.5 workflow)",
-      "usage": "AI-generated screen designs, design.md export, visual design exploration",
-      "healthCheck": {
-        "toolPattern": "stitch",
-        "testCall": "Call list_projects to verify connectivity",
-        "testParams": {},
-        "successIndicator": "Returns a list of projects (possibly empty) without auth errors",
-        "failureHint": "Stitch MCP not responding. Verify gcloud auth: run 'gcloud auth application-default print-access-token'. Check .claude/stitch-proxy.cjs exists and GCP project ID is correct."
-      },
-      "install": {
-        "autoInstall": false,
-        "transport": "stdio",
-        "config": {
-          "command": "node",
-          "args": [".claude/stitch-proxy.cjs"]
-        },
-        "credentials": [
-          {
-            "name": "GCP Project ID",
-            "envVar": "STITCH_GCP_PROJECT",
-            "secret": false,
-            "helpUrl": "https://console.cloud.google.com/projectselector2/home/dashboard"
-          }
-        ],
-        "prerequisites": [
-          {
-            "name": "gcloud CLI",
-            "checkCommand": "gcloud --version",
-            "installUrl": "https://cloud.google.com/sdk/docs/install"
-          }
-        ],
-        "stackRelevance": ["nextjs", "nextjs-neon", "vite"],
-        "warnings": ["Requires gcloud CLI with application-default credentials. Run 'gcloud auth application-default login' before setup.", "Add .claude/stitch-proxy.cjs to .gitignore (contains your GCP project ID)."],
-        "setupGuide": "Run: morph-spec mcp setup stitch (generates OAuth proxy script)"
-      },
-      "companionSkills": {
-        "repo": "google-labs-code/stitch-skills",
-        "installCommand": "npx skills add google-labs-code/stitch-skills",
-        "skills": ["stitch-design", "stitch-loop", "design-md", "prompt-enhance", "react-components", "shadcn-ui"],
-        "description": "Official Stitch agent skills for Claude Code — design generation, multi-page loops, design.md export"
-      }
-    }
-  },
-  "phaseMatrix": {
-    "proposal": ["context7"],
-    "uiux": ["playwright", "context7", "stitch"],
-    "design": ["context7", "github"],
-    "tasks": ["context7", "github"],
-    "implement": ["context7", "playwright", "github", "vercel"]
-  }
-}
+{
+  "version": "4.0.0",
+  "description": "Centralized MCP registry with phase relevance and install configuration for morph-spec workflows",
+  "mcps": {
+    "context7": {
+      "phases": ["proposal", "design", "tasks", "implement"],
+      "tools": ["resolve-library-id", "query-docs"],
+      "detection": "enabledPlugins includes context7 or mcpServers includes context7",
+      "fallback": "WebSearch + WebFetch for library documentation",
+      "usage": "Library documentation lookups, API reference, implementation patterns",
+      "healthCheck": {
+        "toolPattern": "context7",
+        "testCall": "Call resolve-library-id with libraryName 'react' and query 'react hooks'",
+        "testParams": { "libraryName": "react", "query": "react hooks" },
+        "successIndicator": "Returns a library ID (e.g., /facebook/react)",
+        "failureHint": "Context7 MCP not responding. Check that @upstash/context7-mcp is installed and the MCP server is running. Try restarting Claude Code."
+      },
+      "install": {
+        "autoInstall": true,
+        "transport": "stdio",
+        "config": {
+          "type": "stdio",
+          "command": "cmd",
+          "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"]
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["*"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "playwright": {
+      "phases": ["uiux", "implement"],
+      "tools": ["browser_navigate", "browser_snapshot", "browser_take_screenshot", "browser_console_messages", "browser_click", "browser_resize"],
+      "detection": "mcpServers includes playwright",
+      "fallback": "WebFetch for read-only page content, manual testing",
+      "usage": "UI preview, smoke testing, page inspection, responsive testing, screenshot capture",
+      "healthCheck": {
+        "toolPattern": "playwright",
+        "testCall": "Call browser_navigate with url 'about:blank'",
+        "testParams": { "url": "about:blank" },
+        "successIndicator": "Page navigates successfully (no error thrown)",
+        "failureHint": "Playwright MCP not responding. Ensure @playwright/mcp is installed and browser binaries are available. Run 'npx playwright install' if needed."
+      },
+      "install": {
+        "autoInstall": true,
+        "transport": "stdio",
+        "config": {
+          "type": "stdio",
+          "command": "cmd",
+          "args": ["/c", "npx", "-y", "@playwright/mcp@latest"]
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["*"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "github": {
+      "phases": ["tasks", "implement"],
+      "tools": ["get_repo", "search_code", "create_issue", "create_pull_request", "search_issues"],
+      "detection": "mcpServers includes github",
+      "fallback": "Bash `gh` CLI commands",
+      "usage": "Repo metadata, code search, issue creation, PR management",
+      "healthCheck": {
+        "toolPattern": "github",
+        "testCall": "Call any read-only GitHub tool (e.g., search_repositories or get_repo) to verify connectivity",
+        "testParams": {},
+        "successIndicator": "Returns repository data or search results without auth errors",
+        "failureHint": "GitHub MCP not responding. If using Docker, ensure Docker Desktop is running. Verify GITHUB_PERSONAL_ACCESS_TOKEN env var is set. Ensure the token has not expired and has the required scopes (repo, read:org)."
+      },
+      "install": {
+        "autoInstall": false,
+        "transport": "stdio",
+        "config": {
+          "type": "stdio",
+          "command": "docker",
+          "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
+          "env": {
+            "GITHUB_PERSONAL_ACCESS_TOKEN": ""
+          }
+        },
+        "credentials": [
+          {
+            "name": "GitHub Personal Access Token",
+            "envVar": "GITHUB_PERSONAL_ACCESS_TOKEN",
+            "secret": true,
+            "helpUrl": "https://github.com/settings/tokens"
+          }
+        ],
+        "prerequisites": [
+          {
+            "name": "Docker",
+            "checkCommand": "docker --version",
+            "installUrl": "https://docs.docker.com/get-docker/"
+          }
+        ],
+        "stackRelevance": ["*"],
+        "warnings": [],
+        "setupGuide": "Official GitHub MCP Server (github/github-mcp-server). Requires Docker."
+      }
+    },
+    "vercel": {
+      "phases": ["implement"],
+      "tools": ["search_docs", "list_projects", "get_deployments", "get_deployment_logs", "manage_env_vars"],
+      "detection": "mcpServers includes vercel",
+      "fallback": "Bash `vercel` CLI commands",
+      "usage": "Deployment monitoring, project management, environment variables, log analysis",
+      "healthCheck": {
+        "toolPattern": "vercel",
+        "testCall": "Call search_docs with a query to verify connectivity",
+        "testParams": { "query": "deployments" },
+        "successIndicator": "Returns documentation search results without auth errors",
+        "failureHint": "Vercel MCP not responding. Re-authenticate via /mcp in Claude Code. Ensure you have authorized the Vercel OAuth connection."
+      },
+      "install": {
+        "autoInstall": false,
+        "transport": "http",
+        "config": {
+          "type": "http",
+          "url": "https://mcp.vercel.com"
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["nextjs", "nextjs-neon", "vercel"],
+        "warnings": ["Uses OAuth — you will be prompted to authenticate via browser when first connecting."],
+        "setupGuide": "Run: claude mcp add --transport http vercel https://mcp.vercel.com"
+      }
+    },
+    "asaas": {
+      "phases": ["design", "implement"],
+      "tools": ["enumerate_endpoints", "get_endpoint_schema", "generate_code_example", "execute_api_call", "search_docs"],
+      "detection": "mcpServers includes asaas",
+      "fallback": "WebFetch https://docs.asaas.com for API documentation",
+      "usage": "Asaas payment API docs, endpoint schemas, code examples, direct API calls",
+      "healthCheck": {
+        "toolPattern": "asaas",
+        "testCall": "Search Asaas docs for 'payments' to verify connectivity",
+        "testParams": { "query": "payments" },
+        "successIndicator": "Returns documentation results about payment endpoints",
+        "failureHint": "Asaas MCP not responding. Verify the MCP is configured with url: https://docs.asaas.com/mcp"
+      },
+      "install": {
+        "autoInstall": false,
+        "transport": "http",
+        "config": {
+          "type": "http",
+          "url": "https://docs.asaas.com/mcp"
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["asaas"],
+        "warnings": ["API call execution requires your Asaas access_token. Doc search works without authentication."],
+        "setupGuide": "Run: claude mcp add --transport http asaas https://docs.asaas.com/mcp"
+      }
+    },
+    "stitch": {
+      "phases": ["uiux"],
+      "tools": ["create_project", "list_projects", "get_project", "list_screens", "get_screen", "generate_screen_from_text", "fetch_screen_code", "fetch_screen_image"],
+      "detection": "mcpServers includes stitch",
+      "fallback": "HTML mockup + Playwright screenshots (Step 3.5 workflow)",
+      "usage": "AI-generated screen designs, design.md export, visual design exploration",
+      "healthCheck": {
+        "toolPattern": "stitch",
+        "testCall": "Call list_projects to verify connectivity",
+        "testParams": {},
+        "successIndicator": "Returns a list of projects (possibly empty) without auth errors",
+        "failureHint": "Stitch MCP not responding. Verify gcloud auth: run 'gcloud auth application-default print-access-token'. Check .claude/stitch-proxy.cjs exists and GCP project ID is correct."
+      },
+      "install": {
+        "type": "proxy-generate",
+        "autoInstall": false,
+        "transport": "stdio",
+        "config": {
+          "type": "stdio",
+          "command": "node",
+          "args": [".claude/stitch-proxy.cjs"]
+        },
+        "credentials": [
+          {
+            "name": "GCP Project ID",
+            "envVar": "STITCH_GCP_PROJECT",
+            "secret": false,
+            "helpUrl": "https://console.cloud.google.com/projectselector2/home/dashboard"
+          }
+        ],
+        "prerequisites": [
+          {
+            "name": "gcloud CLI",
+            "checkCommand": "gcloud --version",
+            "installUrl": "https://cloud.google.com/sdk/docs/install"
+          }
+        ],
+        "requiredCredentials": ["gcloud-adc"],
+        "setupFn": "setupStitch",
+        "testCall": "initialize",
+        "successIndicator": "protocolVersion",
+        "failureHint": "Run: gcloud auth application-default login && gcloud services enable stitch.googleapis.com",
+        "stackRelevance": ["nextjs", "nextjs-neon", "vite"],
+        "warnings": ["Requires gcloud CLI with application-default credentials. Run 'gcloud auth application-default login' before setup.", "Add .claude/stitch-proxy.cjs to .gitignore (contains your GCP project ID)."],
+        "setupGuide": "Run: morph-spec mcp setup stitch (generates OAuth proxy script)"
+      },
+      "companionSkills": {
+        "repo": "google-labs-code/stitch-skills",
+        "installCommand": "npx skills add google-labs-code/stitch-skills",
+        "skills": ["stitch-design", "stitch-loop", "design-md", "prompt-enhance", "react-components", "shadcn-ui"],
+        "description": "Official Stitch agent skills for Claude Code — design generation, multi-page loops, design.md export"
+      }
+    },
+    "gemini-image": {
+      "phases": ["uiux", "implement"],
+      "tools": ["generate_image", "edit_image", "continue_editing", "list_images", "get_image_info", "get_configuration_status"],
+      "detection": "mcpServers includes gemini-image-mcp",
+      "fallback": "Manual image creation, stock photos, or placeholder divs",
+      "usage": "AI image generation for project assets (heroes, illustrations, brand images) using Gemini models",
+      "healthCheck": {
+        "toolPattern": "gemini-image",
+        "testCall": "Call get_configuration_status to verify API key and server health",
+        "testParams": {},
+        "successIndicator": "Returns status with valid API key configured",
+        "failureHint": "Gemini Image MCP not responding. Ensure GEMINI_API_KEY is set in MCP server configuration. Install: npx gemini-image-mcp@latest"
+      },
+      "install": {
+        "autoInstall": false,
+        "transport": "stdio",
+        "config": {
+          "type": "stdio",
+          "command": "cmd",
+          "args": ["/c", "npx", "-y", "gemini-image-mcp@latest"]
+        },
+        "credentials": [
+          {
+            "name": "Gemini API Key",
+            "envVar": "GEMINI_API_KEY",
+            "source": "Google AI Studio (https://aistudio.google.com/apikey)"
+          }
+        ],
+        "prerequisites": ["Google AI Studio API key"],
+        "stackRelevance": ["nextjs", "next"],
+        "warnings": ["Requires GEMINI_API_KEY environment variable. Image generation costs apply per Google AI pricing."],
+        "setupGuide": "1. Get API key from https://aistudio.google.com/apikey\n2. Run: claude mcp add gemini-image-mcp -- npx gemini-image-mcp@latest\n3. Set GEMINI_API_KEY in MCP env config"
+      }
+    }
+  },
+  "phaseMatrix": {
+    "proposal": ["context7"],
+    "uiux": ["playwright", "context7", "stitch", "gemini-image"],
+    "design": ["context7", "github"],
+    "tasks": ["context7", "github"],
+    "implement": ["context7", "playwright", "github", "vercel", "gemini-image"]
+  }
+}