@thesage/mcp 0.1.0 → 0.2.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 +18 -18
- package/dist/index.js +2 -2
- package/dist/index.mjs +2 -2
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
# @
|
|
1
|
+
# @thesage/mcp
|
|
2
2
|
|
|
3
|
-
**Model Context Protocol server for Sage
|
|
3
|
+
**Model Context Protocol server for Sage Design Engine**
|
|
4
4
|
|
|
5
|
-
Enable AI assistants like Claude Desktop, Cursor, and VS Code to browse, search, and install Sage
|
|
5
|
+
Enable AI assistants like Claude Desktop, Cursor, and VS Code to browse, search, and install Sage Design Engine components directly through natural language.
|
|
6
6
|
|
|
7
7
|
## Features
|
|
8
8
|
|
|
9
|
-
- 🔍 **Browse all
|
|
9
|
+
- 🔍 **Browse all 89 components** across 7 core functional categories
|
|
10
10
|
- 🔎 **Semantic search** by keywords, use cases, or functionality
|
|
11
11
|
- 📖 **Detailed component info** including props, dependencies, and examples
|
|
12
12
|
- 📦 **Installation instructions** with all required dependencies
|
|
@@ -17,11 +17,11 @@ Enable AI assistants like Claude Desktop, Cursor, and VS Code to browse, search,
|
|
|
17
17
|
### Quick Start
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
pnpm add -D @
|
|
20
|
+
pnpm add -D @thesage/mcp
|
|
21
21
|
# or
|
|
22
|
-
npm install --save-dev @
|
|
22
|
+
npm install --save-dev @thesage/mcp
|
|
23
23
|
# or
|
|
24
|
-
yarn add -D @
|
|
24
|
+
yarn add -D @thesage/mcp
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
### MCP Client Configuration
|
|
@@ -35,7 +35,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
|
35
35
|
"mcpServers": {
|
|
36
36
|
"sds": {
|
|
37
37
|
"command": "npx",
|
|
38
|
-
"args": ["@
|
|
38
|
+
"args": ["@thesage/mcp"]
|
|
39
39
|
}
|
|
40
40
|
}
|
|
41
41
|
}
|
|
@@ -52,7 +52,7 @@ Add to `.cursor/mcp.json` in your project:
|
|
|
52
52
|
"mcpServers": {
|
|
53
53
|
"sds": {
|
|
54
54
|
"command": "npx",
|
|
55
|
-
"args": ["@
|
|
55
|
+
"args": ["@thesage/mcp"]
|
|
56
56
|
}
|
|
57
57
|
}
|
|
58
58
|
}
|
|
@@ -67,7 +67,7 @@ Add to `.vscode/mcp.json`:
|
|
|
67
67
|
"servers": {
|
|
68
68
|
"sds": {
|
|
69
69
|
"command": "npx",
|
|
70
|
-
"args": ["@
|
|
70
|
+
"args": ["@thesage/mcp"]
|
|
71
71
|
}
|
|
72
72
|
}
|
|
73
73
|
}
|
|
@@ -85,7 +85,7 @@ List all available components, optionally filtered by category.
|
|
|
85
85
|
- `category` (optional): Filter by `actions`, `forms`, `navigation`, `overlays`, `feedback`, `data-display`, or `layout`
|
|
86
86
|
|
|
87
87
|
**Example AI prompts:**
|
|
88
|
-
- "Show me all Sage
|
|
88
|
+
- "Show me all Sage Design Engine components"
|
|
89
89
|
- "List all form components"
|
|
90
90
|
- "What overlay components are available?"
|
|
91
91
|
|
|
@@ -127,7 +127,7 @@ Get installation instructions for a component.
|
|
|
127
127
|
|
|
128
128
|
## Component Categories
|
|
129
129
|
|
|
130
|
-
The Sage
|
|
130
|
+
The Sage Design Engine organizes components functionally (not atomically):
|
|
131
131
|
|
|
132
132
|
- **Actions** (3) - Interactive elements that trigger behaviors
|
|
133
133
|
- **Forms** (11) - Input controls for data collection
|
|
@@ -143,9 +143,9 @@ Once configured, you can interact with the server through your AI assistant:
|
|
|
143
143
|
|
|
144
144
|
### Browse Components
|
|
145
145
|
|
|
146
|
-
> "Show me all components in the Sage
|
|
146
|
+
> "Show me all components in the Sage Design Engine"
|
|
147
147
|
|
|
148
|
-
The AI will use `list_components` to display all
|
|
148
|
+
The AI will use `list_components` to display all 89 components organized by category.
|
|
149
149
|
|
|
150
150
|
### Search for Specific Functionality
|
|
151
151
|
|
|
@@ -180,7 +180,7 @@ The AI will use `install_component` to provide:
|
|
|
180
180
|
|
|
181
181
|
The MCP server consists of:
|
|
182
182
|
|
|
183
|
-
1. **Component Registry** (`src/registry.ts`) - Metadata for all
|
|
183
|
+
1. **Component Registry** (`src/registry.ts`) - Metadata for all 89 @thesage/ui components
|
|
184
184
|
2. **MCP Server** (`src/index.ts`) - Model Context Protocol implementation
|
|
185
185
|
3. **Tool Handlers** - Four tools for listing, searching, viewing, and installing
|
|
186
186
|
|
|
@@ -204,7 +204,7 @@ The server runs in stdio mode, communicating via stdin/stdout per the MCP specif
|
|
|
204
204
|
|
|
205
205
|
## Documentation
|
|
206
206
|
|
|
207
|
-
- **Full Documentation**: https://
|
|
207
|
+
- **Full Documentation**: https://thesage.dev/
|
|
208
208
|
- **GitHub**: https://github.com/shalomormsby/ecosystem
|
|
209
209
|
- **MCP Specification**: https://modelcontextprotocol.io/
|
|
210
210
|
|
|
@@ -212,7 +212,7 @@ The server runs in stdio mode, communicating via stdin/stdout per the MCP specif
|
|
|
212
212
|
|
|
213
213
|
For issues or questions:
|
|
214
214
|
- GitHub Issues: https://github.com/shalomormsby/ecosystem/issues
|
|
215
|
-
- Documentation: https://
|
|
215
|
+
- Documentation: https://thesage.dev/#mcp-server
|
|
216
216
|
|
|
217
217
|
## License
|
|
218
218
|
|
|
@@ -220,4 +220,4 @@ MIT © Shalom Ormsby
|
|
|
220
220
|
|
|
221
221
|
---
|
|
222
222
|
|
|
223
|
-
**Part of the [Sage
|
|
223
|
+
**Part of the [Sage Design Engine](https://thesage.dev/) - Build lovable products at AI speed.**
|
package/dist/index.js
CHANGED
|
@@ -897,7 +897,7 @@ import { ${component.name} } from '@thesage/ui';
|
|
|
897
897
|
`;
|
|
898
898
|
output += `## Documentation
|
|
899
899
|
`;
|
|
900
|
-
output += `View full documentation at: https://
|
|
900
|
+
output += `View full documentation at: https://thesage.dev/#${component.category}/${component.name.toLowerCase().replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase()}
|
|
901
901
|
`;
|
|
902
902
|
return output;
|
|
903
903
|
}
|
|
@@ -966,7 +966,7 @@ function formatInstallationInstructions(component) {
|
|
|
966
966
|
output += `## Additional Resources
|
|
967
967
|
|
|
968
968
|
`;
|
|
969
|
-
output += `- **Documentation:** https://
|
|
969
|
+
output += `- **Documentation:** https://thesage.dev/#${component.category}/${component.name.toLowerCase().replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase()}
|
|
970
970
|
`;
|
|
971
971
|
output += `- **GitHub:** https://github.com/shalomormsby/ecosystem/tree/main/packages/ui/src/components/${component.category}
|
|
972
972
|
`;
|
package/dist/index.mjs
CHANGED
|
@@ -899,7 +899,7 @@ import { ${component.name} } from '@thesage/ui';
|
|
|
899
899
|
`;
|
|
900
900
|
output += `## Documentation
|
|
901
901
|
`;
|
|
902
|
-
output += `View full documentation at: https://
|
|
902
|
+
output += `View full documentation at: https://thesage.dev/#${component.category}/${component.name.toLowerCase().replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase()}
|
|
903
903
|
`;
|
|
904
904
|
return output;
|
|
905
905
|
}
|
|
@@ -968,7 +968,7 @@ function formatInstallationInstructions(component) {
|
|
|
968
968
|
output += `## Additional Resources
|
|
969
969
|
|
|
970
970
|
`;
|
|
971
|
-
output += `- **Documentation:** https://
|
|
971
|
+
output += `- **Documentation:** https://thesage.dev/#${component.category}/${component.name.toLowerCase().replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase()}
|
|
972
972
|
`;
|
|
973
973
|
output += `- **GitHub:** https://github.com/shalomormsby/ecosystem/tree/main/packages/ui/src/components/${component.category}
|
|
974
974
|
`;
|
package/package.json
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@thesage/mcp",
|
|
3
|
-
"version": "0.1
|
|
4
|
-
"description": "Model Context Protocol server for Sage
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "Model Context Protocol server for Sage Design Engine - discover and integrate components with AI assistants",
|
|
5
5
|
"author": "Shalom Ormsby",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
8
8
|
"url": "https://github.com/shalomormsby/ecosystem.git",
|
|
9
|
-
"directory": "packages/
|
|
9
|
+
"directory": "packages/mcp"
|
|
10
10
|
},
|
|
11
|
-
"homepage": "https://
|
|
11
|
+
"homepage": "https://thesage.dev/#mcp-server",
|
|
12
12
|
"bugs": "https://github.com/shalomormsby/ecosystem/issues",
|
|
13
13
|
"publishConfig": {
|
|
14
14
|
"access": "public"
|