{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_84ntkbn788h3","handle":"storybook-mcp-2","url":"https://wellknown.network/agents/storybook-mcp-2","links":{"self":"https://wellknown.network/agents/storybook-mcp-2/record.json","html":"https://wellknown.network/agents/storybook-mcp-2","markdown":"https://wellknown.network/agents/storybook-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/storybook-mcp-2","status":"https://wellknown.network/api/v1/agents/storybook-mcp-2/status","claim":"https://wellknown.network/agents/storybook-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/storybook-mcp-2/claim.json","badge":"https://wellknown.network/agents/storybook-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/storybook-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/storybook-mcp-2/tools"},"ard":{"identifier":"urn:air::server:storybook-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"storybook-mcp","summary":"MCP server for Storybook integration – browse, inspect, and scaffold components","description":"# Storybook MCP Server\n\nAn MCP (Model Context Protocol) server that integrates with a running **Storybook** instance. It lets AI-powered coding tools browse your component library, inspect individual components, and scaffold brand-new components from natural language.\n\n## Features\n\n| Tool | Description |\n|---|---|\n| `storybook_list_components` | List & search every component in your running Storybook |\n| `storybook_get_component` | Get stories, arg types, default args, and Storybook URLs for a component |\n| `storybook_create_component` | Scaffold a component + Storybook story from a plain-English description |\n| `storybook_compose_view` | Compose existing components into a higher-order page/view with layout, state, and wiring |\n\n## Quick Start\n\n### Prerequisites\n\n- Python ≥ 3.10\n- A running Storybook instance (v7+)\n- [`uv`](https://docs.astral.sh/uv/) installed\n\n### 1. Install uv if needed (Python Package Manager)\n\n```bash\n# Install via Homebrew\nbrew install uv\n\n# Or via curl\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**Note:** The `storybook-mcp` package itself does NOT need to be installed separately. The MCP configuration uses `uvx` which automatically downloads and runs the package when needed.\n\n## Configuration by Editor\n\n### Configuration Format A: Project-Relative Paths\n\nUse this configuration for **Cursor**, **Windsurf**, **Roo Code**, and **Kilo Code**.\n\n```json\n{\n  \"mcpServers\": {\n    \"storybook\": {\n      \"command\": \"uvx\",\n      \"args\": [\"storybook-mcp\"],\n      \"env\": {\n        \"STORYBOOK_URL\": \"http://localhost:6006\",\n        \"STORYBOOK_COMPONENTS_DIR\": \"relative/path/to/your/storybook/components\",\n        \"STORYBOOK_FRAMEWORK\": \"react\",\n        \"STORYBOOK_STYLE_TECH\": \"tailwind\",\n        \"STORYBOOK_TYPESCRIPT\": \"true\"\n      }\n    }\n  }\n}\n```\n\n**Configuration File Locations:**\n\n- **Cursor:** `.cursor/mcp.json` (project root - already created in this project)\n- **Windsurf:** `.windsurf/mcp.json` (project root)\n- **Roo Code:** `.roo/mcp.json` (pr…","publisher":null,"homepage":"https://github.com/stevebrownlee/storybook-mcp#readme","repository":"https://github.com/stevebrownlee/storybook-mcp#readme","version":"0.3.1","license":"MIT","protocols":["mcp"],"tags":["ai-agents","components","design-system","mcp","storybook"],"pricing":null,"endpoints":[{"url":"pypi:storybook-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.3d","name":"3D & Design","confidence":0.638,"provenance":"derived"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"storybook-mcp","registry":"pypi","observedAt":"2026-11-04T01:24:56.774Z","publishedAt":"2026-02-13T17:38:05.932941Z","latestVersion":"0.3.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"storybook-mcp","url":"https://pypi.org/project/storybook-mcp/","firstSeenAt":"2026-09-10T13:19:49.734Z","fetchedAt":"2026-11-04T01:23:57.189Z","normalizedAt":"2026-11-04T01:23:57.189Z"}]},"firstSeenAt":"2026-09-10T13:19:49.734Z","updatedAt":"2026-11-04T01:24:56.774Z"}