@neuctra/ui-mcp 0.1.0

package/README.md

@@ -0,0 +1,71 @@
+# @neuctra/ui-mcp
+
+An MCP (Model Context Protocol) server that gives AI coding assistants ground-truth
+knowledge of the [`@neuctra/ui`](../neuctra-ui-package) component library — real prop
+names, types, defaults, and usage examples straight from source, plus the semantic
+theming rules — so generated code doesn't guess or hallucinate.
+
+## Tools
+
+- **`list_components`** — list all components, optionally filtered by category
+  (`layout`, `typography`, `form`, `actions`, `data-display`, `feedback`, `overlay`,
+  `navigation`).
+- **`get_component`** — full spec for one component: every prop (type, required,
+  default, description) plus a real usage example scraped from the docs site.
+- **`search_components`** — keyword search across name/category/description/prop names.
+- **`get_theme`** — the semantic color token system (`bg-primary`, `text-foreground`, ...)
+  and the rule set for using it instead of hardcoded Tailwind colors, so generated UI
+  respects the consumer's light/dark theme.
+
+## Data source
+
+`data/components.json` is a synced copy of
+[`neuctra-ui-package/registry/components.json`](../neuctra-ui-package/registry/components.json),
+which is generated from the TypeScript source via `npm run registry:generate` in that
+package (parses prop interfaces + JSDoc with `ts-morph`, plus scrapes one usage example
+per component from the docs site). Run `npm run sync-registry` here after regenerating it
+there. `data/theme.json` is hand-curated from the CLI's CSS template
+(`neuctra-ui-cli/lib/update-css.js`) and updated manually if the token set changes.
+
+## Local development
+
+```bash
+npm install
+npm run sync-registry   # pulls the latest registry.json from neuctra-ui-package
+npm start                # runs the server on stdio
+```
+
+## Using with Claude Code / Claude Desktop
+
+Add to your MCP config (`.mcp.json` for a project, or Claude Desktop's config file):
+
+```json
+{
+  "mcpServers": {
+    "neuctra-ui": {
+      "command": "npx",
+      "args": ["-y", "@neuctra/ui-mcp"]
+    }
+  }
+}
+```
+
+Or, for local development against this repo:
+
+```json
+{
+  "mcpServers": {
+    "neuctra-ui": {
+      "command": "node",
+      "args": ["/absolute/path/to/neuctra-ui-mcp/bin/cli.mjs"]
+    }
+  }
+}
+```
+
+## Publishing
+
+```bash
+npm run sync-registry   # or rely on prepublishOnly, which does this automatically
+npm publish --access public
+```

package/bin/cli.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "../src/server.mjs";
+
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);