@kazee-ds/mcp 0.0.0-stage → 0.1.2

package/README.md

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# Kazee Design System MCP
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Read-only, offline stdio tools for the public React and Vue APIs. No Storybook process is required. The server never installs packages, executes commands, scans a project or reads registry credentials.
+
+## Configuration
+
+After publishing this package to the public npm registry, merge this entry into the application's Claude Code `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "kazee": {
+      "command": "npx",
+      "args": ["-y", "@kazee-ds/mcp@0.1.2"]
+    }
+  }
+}
+```
+
+Before publication, use `node` with the absolute `bin/kazee-mcp.mjs` path from a local checkout or installed `.tgz` package. Other clients use their own MCP configuration format. Preserve existing servers; restart/reconnect the client after configuration changes. Public npm downloads need no read token; the running server itself needs no network connection. Keep actual tokens out of `.mcp.json`.
+
+## Tools
+
+Catalog `0.4.0` is verified against public npm archives: 37 component families, React/Vue declarations and examples, and light/dark semantic tokens. Public installation needs no read token. Historical `0.2.0` and `0.3.0` catalogs retain their original private GitLab provenance. The separate `0.4.0-workspace` selector is only for reviewing the checkout or matching local packed artifacts; it is not a registry installation version. Reconnect the MCP client after updating to reload the catalog.
+
+1. `get_catalog_versions`: exact supported versions and provenance.
+2. `list_components`: browse/search by framework, version, function or keyword.
+3. `get_component_docs`: public props, discriminated variants, related types, Vue events/slots and composition limits.
+4. `get_component_examples`: complete, typechecked TSX/Vue examples.
+5. `get_theme_variables`: semantic light/dark CSS variables and resolved values.
+6. `get_installation`: pinned package commands, global CSS and lint guidance.
+7. `get_guides`: agent workflow, framework differences, styling and application composition.
+
+All tools carry read-only annotations. `kazee://guides/workflow` and `kazee://catalog/versions` are also exposed as resources.
+
+Always supply the exact installed framework package version, obtained from its public package manifest or lockfile. The server rejects unknown versions instead of substituting newer APIs. Both `0.2.0` (eight components per framework) and `0.3.0` (32 per framework) use declarations and tokens extracted from published GitLab registry archives. Their provenance retains SHA-256 archive hashes. The retained catalogs correct the stale candidate label shipped in MCP `0.1.0`. New public MCP `0.1.2` publication is a separate step. Registry verification records a build-time check, not live registry availability.
+
+Examples use public `@kazee-ds/react` / `@kazee-ds/vue` imports. The package does not provide shadcn-style component source installation or hosted HTTP transport. MCP supplies reference material; AGENTS.md and consumer lint guide and enforce usage. Successful tool calls do not establish agent instruction-following or production adoption.

package/bin/kazee-mcp.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from '../src/server.mjs';
+
+const args = process.argv.slice(2);
+if (args.length === 1 && ['--help', '-h'].includes(args[0])) {
+  console.log(
+    'Kazee Design System MCP (React + Vue)\nUsage: kazee-mcp [--version | --help]\nNo arguments: read-only MCP server over stdio. No HTTP listener or project scans.',
+  );
+} else if (args.length === 1 && args[0] === '--version') {
+  console.log(
+    JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version,
+  );
+} else if (args.length) {
+  console.error('Unsupported arguments. Use kazee-mcp --help.');
+  process.exitCode = 1;
+} else {
+  try {
+    await createServer().connect(new StdioServerTransport());
+  } catch (error) {
+    console.error(`Kazee MCP could not start: ${error.message}`);
+    process.exitCode = 1;
+  }
+}