@shadsapp/mcp 0.1.0 → 0.1.1
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 +65 -0
- package/package.json +5 -4
package/README.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# @shadsapp/mcp
|
|
2
|
+
|
|
3
|
+
[MCP](https://modelcontextprotocol.io) server for [shads.app](https://shads.app) theme discovery and validation.
|
|
4
|
+
|
|
5
|
+
Lets AI agents list public themes, fetch theme bundles, and validate `theme.json` documents.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @shadsapp/mcp
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Cursor / Claude Desktop config
|
|
14
|
+
|
|
15
|
+
```json
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"shads": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["-y", "@shadsapp/mcp"]
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Or use the built binary after install:
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"mcpServers": {
|
|
31
|
+
"shads": {
|
|
32
|
+
"command": "shads-mcp"
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Tools
|
|
39
|
+
|
|
40
|
+
| Tool | Description |
|
|
41
|
+
|------|-------------|
|
|
42
|
+
| `list_themes` | List curated public starter themes |
|
|
43
|
+
| `get_theme` | Get `theme.json` + `theme.css` for a theme id |
|
|
44
|
+
| `validate_theme` | Validate a `theme.json` string |
|
|
45
|
+
| `theme_schema` | Return the active schema id (`shads-theme/v1`) |
|
|
46
|
+
|
|
47
|
+
## Example: get workspace theme
|
|
48
|
+
|
|
49
|
+
Tool: `get_theme`
|
|
50
|
+
|
|
51
|
+
```json
|
|
52
|
+
{ "id": "workspace" }
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Returns theme metadata, parsed document, and CSS.
|
|
56
|
+
|
|
57
|
+
## Related packages
|
|
58
|
+
|
|
59
|
+
- [`@shadsapp/schema`](https://www.npmjs.com/package/@shadsapp/schema)
|
|
60
|
+
- [`@shadsapp/themes`](https://www.npmjs.com/package/@shadsapp/themes)
|
|
61
|
+
- [`@shadsapp/cli`](https://www.npmjs.com/package/@shadsapp/cli)
|
|
62
|
+
|
|
63
|
+
## License
|
|
64
|
+
|
|
65
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shadsapp/mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "MCP server for shads theme discovery and validation",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
"shads-mcp": "./dist/index.js"
|
|
9
9
|
},
|
|
10
10
|
"files": [
|
|
11
|
-
"dist"
|
|
11
|
+
"dist",
|
|
12
|
+
"README.md"
|
|
12
13
|
],
|
|
13
14
|
"exports": {
|
|
14
15
|
".": {
|
|
@@ -22,8 +23,8 @@
|
|
|
22
23
|
},
|
|
23
24
|
"dependencies": {
|
|
24
25
|
"@modelcontextprotocol/sdk": "^1.17.5",
|
|
25
|
-
"@shadsapp/schema": "0.1.
|
|
26
|
-
"@shadsapp/themes": "0.1.
|
|
26
|
+
"@shadsapp/schema": "0.1.1",
|
|
27
|
+
"@shadsapp/themes": "0.1.1"
|
|
27
28
|
},
|
|
28
29
|
"publishConfig": {
|
|
29
30
|
"access": "public"
|