Merge pull request #202 from storybookjs/shilman/add-registry-server-json

Add MCP registry metadata for @storybook/addon-mcp

Author: JReinhold

.changeset/neat-otters-reflect.md

@@ -0,0 +1,5 @@
+---
+'@storybook/addon-mcp': patch
+---
+
+Add MCP registry metadata for `@storybook/addon-mcp`.

.github/workflows/release.yml

@@ -44,3 +44,43 @@ jobs:
           commitMode: github-api
         env:
           GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
+
+      # See: https://modelcontextprotocol.io/registry/github-actions
+      - name: Install mcp-publisher
+        if: steps.changesets.outputs.published == 'true' && contains(steps.changesets.outputs.publishedPackages, '@storybook/addon-mcp')
+        working-directory: packages/addon-mcp
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+
+      - name: Authenticate to MCP Registry
+        if: steps.changesets.outputs.published == 'true' && contains(steps.changesets.outputs.publishedPackages, '@storybook/addon-mcp')
+        working-directory: packages/addon-mcp
+        run: ./mcp-publisher login github-oidc
+
+      - name: Sync addon MCP registry version with jq
+        if: steps.changesets.outputs.published == 'true' && contains(steps.changesets.outputs.publishedPackages, '@storybook/addon-mcp')
+        working-directory: packages/addon-mcp
+        run: |
+          # Pull the published addon version directly from Changesets output.
+          # The output is a JSON array like:
+          # [{"name":"@storybook/addon-mcp","version":"0.4.1"}, ...]
+          ADDON_MCP_VERSION="$(jq -r '.[] | select(.name == "@storybook/addon-mcp") | .version' <<< '${{ steps.changesets.outputs.publishedPackages }}')"
+
+          # Fail fast if the package was expected to publish but no version was found.
+          test -n "$ADDON_MCP_VERSION"
+
+          # Update only the server.json fields that need to match the published package version:
+          # 1. the top-level MCP server version
+          # 2. the local npm package entry version used for installation metadata
+          jq --tab --arg version "$ADDON_MCP_VERSION" '
+            .version = $version |
+            .packages[0].version = $version
+          ' server.json > server.json.tmp
+
+          # Replace the original file only after jq succeeds, to avoid partial writes.
+          mv server.json.tmp server.json
+
+      - name: Publish addon MCP to MCP Registry
+        if: steps.changesets.outputs.published == 'true' && contains(steps.changesets.outputs.publishedPackages, '@storybook/addon-mcp')
+        working-directory: packages/addon-mcp
+        run: ./mcp-publisher publish

.gitignore

@@ -13,3 +13,5 @@ test-report.junit.xml
 trials/
 orchestration-logs/
 CLAUDE.local.md
+.mcpregistry_github_token
+.mcpregistry_registry_token

packages/addon-mcp/package.json

@@ -10,6 +10,7 @@
 	"license": "MIT",
 	"author": "Storybook Core Team",
 	"repository": {
+		"type": "git",
 		"url": "git+https://github.com/storybookjs/mcp.git",
 		"directory": "packages/addon-mcp"
 	},
@@ -58,6 +59,7 @@
 			"optional": true
 		}
 	},
+	"mcpName": "io.github.storybookjs/addon-mcp",
 	"storybook": {
 		"displayName": "Addon MCP",
 		"supportedFrameworks": [

packages/addon-mcp/server.json

@@ -0,0 +1,48 @@
+{
+	"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+	"name": "io.github.storybookjs/addon-mcp",
+	"title": "Storybook MCP Addon",
+	"description": "Help agents automatically write and test stories for your UI components.",
+	"websiteUrl": "https://storybook.js.org/docs/ai/mcp/overview",
+	"icons": [
+		{
+			"src": "https://raw.githubusercontent.com/storybookjs/brand/main/icon/icon-storybook-default.svg",
+			"mimeType": "image/svg+xml",
+			"sizes": ["any"],
+			"theme": "light"
+		},
+		{
+			"src": "https://raw.githubusercontent.com/storybookjs/brand/main/icon/icon-storybook-inverse.svg",
+			"mimeType": "image/svg+xml",
+			"sizes": ["any"],
+			"theme": "dark"
+		}
+	],
+	"repository": {
+		"url": "https://github.com/storybookjs/mcp",
+		"source": "github",
+		"id": "1042284426",
+		"subfolder": "packages/addon-mcp"
+	},
+	"version": "0.4.1",
+	"packages": [
+		{
+			"registryType": "npm",
+			"identifier": "@storybook/addon-mcp",
+			"version": "0.4.1",
+			"transport": {
+				"type": "streamable-http",
+				"url": "http://localhost:{--port}/mcp"
+			},
+			"packageArguments": [
+				{
+					"type": "named",
+					"name": "--port",
+					"description": "Port of the Storybook dev server exposing the MCP endpoint.",
+					"default": "6006",
+					"format": "number"
+				}
+			]
+		}
+	]
+}