mcp

Welcome to the Storybook MCP Addon monorepo! This project enables AI agents to work more efficiently with Storybook by providing an MCP (Model Context Protocol) server that exposes UI component information and development workflows.

This monorepo contains two main packages:

• [@storybook/mcp](./packages/mcp) - Standalone MCP library for serving Storybook component knowledge (can be used independently)
• [@storybook/addon-mcp](./packages/addon-mcp) - Storybook addon that runs an MCP server within your Storybook dev server, and includes the functionality of [@storybook/mcp](./packages/mcp) from your local Storybook

Each package has its own README with user-facing documentation. This document is for contributors looking to develop, test, or contribute to these packages.

• Node.js 24+ - The project requires Node.js 24 or higher (see .nvmrc)
• pnpm 10.19.0+ - Strict package manager requirement (enforced in package.json)

# Use the correct Node version
nvm use

# Install pnpm if you don't have it
npm install -g pnpm@10.19.0

# Clone the repository
git clone https://github.com/storybookjs/mcp.git
cd addon-mcp

# Install all dependencies (for all packages in the monorepo)
pnpm install

# Build all packages
pnpm build

# Start development mode (watches for changes in all packages)
pnpm dev

# Run unit tests in watch mode
pnpm test

# Run unit tests once
pnpm test:run

# Run Storybook with the addon for testing
pnpm --filter internal-storybook storybook

The Storybook command starts:

• The internal test Storybook instance on http://localhost:6006
• The addon in watch mode, so changes are reflected automatically
• MCP server available at http://localhost:6006/mcp

The turbo watch build command runs all packages in watch mode, automat