Storybook MCP Server

⚠️ This tool was created for testing purposes and is not recommended for use in production environments.

---

Getting Started

Before you begin, you need to prepare your Storybook static files. https://storybook.js.org/docs/sharing/publish-storybook

1. Clone the repository

git clone https://github.com/m-yoshiro/storybook-mcp.git
cd storybook-mcp

2. Install dependencies

We recommend using Bun

bun install
# or
npm install

3. Build

bun run build
# or
npm run build

4. Set up

{
  "mcpServers": {
    "storybook-mcp": {
      "command": "node",
      "args": [
        "/< your path>/index.js",
        // Optional: path to your Storybook static json file
        "/< your path>/index.json"
      ]
    }
  }
}

The server will load your Storybook data and expose MCP tools to external agents.

---

🔧 Available Tools

Tool Name	Description	Parameters
list-components	Lists all available components from Storybook	path (optional): Path to the index.json or stories.json file (optional if default path is provided)
find-components-by-name	Finds components based on a keyword (partial match supported)	name: Component name or keyword to search for path (optional): Path to the index.json or stories.json file (optional if default path is provided)

---