Merge pull request #16 from storybookjs/shilman/improve-readme

Improve README and package description

Author: shilman

.changeset/three-buckets-serve.md

@@ -0,0 +1,5 @@
+---
+"@storybook/addon-mcp": patch
+---
+
+Improve README

README.md

@@ -1,6 +1,10 @@
 # Storybook MCP Addon
 
-This Storybook addon provides an MCP (Model Context Protocol) server, enabling AI agents to interact with your Storybook instance. The addon currently allows agents to get UI development instructions and retrieve story URLs directly from your running Storybook.
+This Storybook addon runs an MCP (Model Context Protocol) server to help develop UI components more efficiently.
+
+It enables a workflow where for each UI component created, the agent will automatically generate and link to example stories. These stories let you visually verify the new UI in each of its key states, and provides documentation and component tests.
+
+The server currently exposes two tools: one to provides UI development instructions to the agent, and the other to retrieve story URLs directly from your runnng Storybook.
 
 > [!IMPORTANT]
 > This addon currently only supports Vite-based Storybook setups, such as [`@storybook/react-vite`](https://storybook.js.org/docs/get-started/frameworks/react-vite), [`@storybook/nextjs-vite`](https://storybook.js.org/docs/get-started/frameworks/nextjs#with-vite), and [`@storybook/sveltekit`](https://storybook.js.org/docs/get-started/frameworks/sveltekit).

package.json

@@ -1,9 +1,9 @@
 {
   "name": "@storybook/addon-mcp",
   "version": "0.0.4",
-  "description": "everything you need to build a Storybook addon",
+  "description": "Help agents automatically write and test stories for your UI components",
   "keywords": [
-    "storybook-addons",
+    "storybook-addon",
     "mcp",
     "ai"
   ],