@kazee-ds/mcp 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,40 +1,42 @@
1
- # Kazee Design System MCP
2
-
3
- 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.
4
-
5
- ## Configuration
6
-
7
- After publishing this package to the public npm registry, merge this entry into the application's Claude Code `.mcp.json`:
8
-
9
- ```json
10
- {
11
- "mcpServers": {
12
- "kazee": {
13
- "command": "npx",
14
- "args": ["-y", "@kazee-ds/mcp@0.1.2"]
15
- }
16
- }
17
- }
18
- ```
19
-
20
- 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`.
21
-
22
- ## Tools
23
-
24
- 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.
25
-
26
- The workspace selector additionally documents the unpublished `Toast`/`ToastProvider` family and complete manager examples. `get_guides` topic `toast` explains queue/timer/promise behavior and the release boundary. Registry-verified `0.4.0` intentionally does not expose these new exports. Build this checkout for local MCP review; the existing published MCP `0.1.2` is unchanged until a later release.
27
-
28
- 1. `get_catalog_versions`: exact supported versions and provenance.
29
- 2. `list_components`: browse/search by framework, version, function or keyword.
30
- 3. `get_component_docs`: public props, discriminated variants, related types, Vue events/slots and composition limits.
31
- 4. `get_component_examples`: complete, typechecked TSX/Vue examples.
32
- 5. `get_theme_variables`: semantic light/dark CSS variables and resolved values.
33
- 6. `get_installation`: pinned package commands, global CSS and lint guidance.
34
- 7. `get_guides`: agent workflow, framework differences, styling and application composition.
35
-
36
- All tools carry read-only annotations. `kazee://guides/workflow` and `kazee://catalog/versions` are also exposed as resources.
37
-
38
- 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.
39
-
40
- 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.
1
+ # Kazee Design System MCP
2
+
3
+ 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.
4
+
5
+ ## Configuration
6
+
7
+ After confirming MCP `0.1.5` publication, merge this entry into the application's Claude Code `.mcp.json`:
8
+
9
+ ```json
10
+ {
11
+ "mcpServers": {
12
+ "kazee": {
13
+ "command": "npx",
14
+ "args": ["-y", "@kazee-ds/mcp@0.1.5"]
15
+ }
16
+ }
17
+ }
18
+ ```
19
+
20
+ 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`.
21
+
22
+ ## Tools
23
+
24
+ MCP `0.1.5` retains registry-verified catalogs `0.2.0`, `0.3.0`, `0.4.0`, `0.5.1`, and `0.5.2`. The `0.5.2` catalog uses React/Vue/styles `0.5.2` and tokens/lint `0.4.1`; the retained `0.5.1` catalog keeps its original tokens/lint `0.4.0`. These snapshots come from actual npm archives with checksum provenance, including Toast/ToastProvider and optional close/progress controls.
25
+
26
+ Use the exact installed framework version. The separate `0.5.2-workspace` preview is for checkout review and matching local packed artifacts. Confirm this MCP patch is published, update the exact client pin and reconnect before using its new verified catalogs through npx. Older MCP `0.1.4` retains verified catalogs only through `0.4.0` and labels `0.5.1` as a workspace candidate.
27
+
28
+ Public npm installation needs no read token. Historical snapshots retain their original registry provenance and are never overwritten. See the [version matrix](https://gitlab.com/kazee.indonesia/kazee-design-system/-/blob/main/docs/versions.md).
29
+
30
+ 1. `get_catalog_versions`: exact supported versions and provenance.
31
+ 2. `list_components`: browse/search by framework, version, function or keyword.
32
+ 3. `get_component_docs`: public props, discriminated variants, related types, Vue events/slots and composition limits.
33
+ 4. `get_component_examples`: complete, typechecked TSX/Vue examples.
34
+ 5. `get_theme_variables`: semantic light/dark CSS variables and resolved values.
35
+ 6. `get_installation`: pinned package commands, global CSS and lint guidance.
36
+ 7. `get_guides`: agent workflow, framework differences, styling and application composition.
37
+
38
+ All tools carry read-only annotations. `kazee://guides/workflow` and `kazee://catalog/versions` are also exposed as resources.
39
+
40
+ 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`. Publishing a new MCP catalog is a separate release step. Registry verification records a build-time check, not live registry availability.
41
+
42
+ 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.