@spaced-out/genesis-mcp 1.0.0

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 ADDED
@@ -0,0 +1,60 @@
1
+ # Genesis MCP Server
2
+
3
+ MCP server for AI assistants to access the Genesis UI Design System.
4
+
5
+ ## Quick Setup
6
+
7
+ ### Cursor / Claude Desktop
8
+
9
+ 1. Find your `npx` path:
10
+
11
+ ```bash
12
+ which npx
13
+ ```
14
+
15
+ 2. Add to MCP settings:
16
+
17
+ ```json
18
+ {
19
+ "mcpServers": {
20
+ "genesis-design-system": {
21
+ "command": "/opt/homebrew/bin/npx",
22
+ "args": ["-y", "@spaced-out/genesis-mcp@latest"]
23
+ }
24
+ }
25
+ }
26
+ ```
27
+
28
+ > Replace `/opt/homebrew/bin/npx` with your actual path from step 1.
29
+
30
+ 3. Restart the app.
31
+
32
+ ## Available Tools
33
+
34
+ | Tool | Description |
35
+ | -------------------------------- | ----------------------------- |
36
+ | `list_components` | List all components |
37
+ | `get_component` | Get component details & types |
38
+ | `search_components` | Search by name |
39
+ | `list_hooks` | List all hooks |
40
+ | `get_hook` | Get hook details |
41
+ | `get_design_tokens` | Get design tokens |
42
+ | `get_component_template` | New component template |
43
+ | `get_css_module_guidelines` | CSS Module patterns |
44
+ | `analyze_component_dependencies` | Dependency analysis |
45
+
46
+ ## Development
47
+
48
+ ```bash
49
+ yarn install
50
+ yarn build # Generate design-system.json
51
+ node index.js # Test locally
52
+ ```
53
+
54
+ ## Troubleshooting
55
+
56
+ **"spawn npx ENOENT"**: Use full path to `npx` (see setup above).
57
+
58
+ **Package not found**: Run `npm view @spaced-out/genesis-mcp` to verify.
59
+
60
+ **Node version**: Requires Node.js >= 18.0.0