mozaic-mcp-server 2.5.4 → 2.5.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 +98 -22
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -16,6 +16,104 @@ This package provides two complementary tools for working with the Mozaic Design
|
|
|
16
16
|
- **🤖 Claude Code Skills** - 7 interactive skills for guided component building and design token usage
|
|
17
17
|
- **🔌 MCP Server** - Model Context Protocol server with 17 tools for programmatic access to Mozaic resources
|
|
18
18
|
|
|
19
|
+
## HTTP API
|
|
20
|
+
|
|
21
|
+
Public MCP server available at **https://mozaic-mcp.m14i.com**
|
|
22
|
+
|
|
23
|
+
**Endpoints:**
|
|
24
|
+
- `GET /health` - Health check
|
|
25
|
+
- `POST /mcp/list-tools` - List available tools
|
|
26
|
+
- `POST /mcp/call-tool` - Call a specific tool
|
|
27
|
+
- `GET /api` - [Swagger documentation](https://mozaic-mcp.m14i.com/api)
|
|
28
|
+
|
|
29
|
+
**Authentication:** Bearer token required. [Contact me](https://adeo-tech-community.slack.com/archives/D05E2CXR8TB) on Slack for access.
|
|
30
|
+
|
|
31
|
+
**Example:**
|
|
32
|
+
```bash
|
|
33
|
+
curl -X POST https://mozaic-mcp.m14i.com/mcp/list-tools \
|
|
34
|
+
-H "Authorization: Bearer YOUR_TOKEN" \
|
|
35
|
+
-H "Content-Type: application/json"
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
<details>
|
|
39
|
+
<summary>Example Response (17 MCP Tools)</summary>
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"tools": [
|
|
44
|
+
{
|
|
45
|
+
"name": "get_design_tokens",
|
|
46
|
+
"description": "Get Mozaic design tokens with CSS/SCSS variables. Categories: colors (brand, semantic, component), typography (font sizes, weights, line heights), spacing (magic unit scale), shadows, borders, screens (breakpoints), grid (gutters)."
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
"name": "get_component_info",
|
|
50
|
+
"description": "Get Vue/React component details: props (types, defaults, required), slots, events, and code examples."
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"name": "list_components",
|
|
54
|
+
"description": "List Mozaic Vue/React components by category."
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"name": "generate_vue_component",
|
|
58
|
+
"description": "Generate ready-to-use Vue 3 code with Mozaic components (@mozaic-ds/vue-3)."
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"name": "generate_react_component",
|
|
62
|
+
"description": "Generate ready-to-use React/TSX code with Mozaic components (@mozaic-ds/react)."
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"name": "search_documentation",
|
|
66
|
+
"description": "Search Mozaic Design System documentation for installation guides, component usage, configuration, styling, tokens, patterns, and best practices."
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"name": "get_css_utility",
|
|
70
|
+
"description": "Get CSS utility classes and examples for Mozaic layout and spacing utilities."
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"name": "list_css_utilities",
|
|
74
|
+
"description": "List Mozaic CSS-only utilities (no framework needed)."
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"name": "search_icons",
|
|
78
|
+
"description": "Search Mozaic Design System icons by name or type."
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
"name": "get_icon",
|
|
82
|
+
"description": "Get a specific Mozaic icon by name with SVG markup and ready-to-use code for React/Vue."
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
"name": "get_install_info",
|
|
86
|
+
"description": "Get installation commands and import statements for a Mozaic component."
|
|
87
|
+
},
|
|
88
|
+
{
|
|
89
|
+
"name": "generate_webcomponent",
|
|
90
|
+
"description": "Generate ready-to-use Web Component code using Mozaic Design System (@adeo/mozaic-web-components)."
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"name": "get_webcomponent_info",
|
|
94
|
+
"description": "Get detailed information about a Mozaic Web Component including attributes, slots, events, CSS custom properties, and usage examples."
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"name": "list_webcomponents",
|
|
98
|
+
"description": "List available Mozaic Web Components by category."
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"name": "generate_freemarker",
|
|
102
|
+
"description": "Generate ready-to-use Freemarker macro code with import statements and configuration examples for Mozaic components."
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"name": "get_freemarker_info",
|
|
106
|
+
"description": "Get detailed information about a Freemarker component including configuration options, CSS classes, and usage examples."
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"name": "list_freemarker",
|
|
110
|
+
"description": "List available Mozaic Freemarker macros by category."
|
|
111
|
+
}
|
|
112
|
+
]
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
</details>
|
|
116
|
+
|
|
19
117
|
### What's Included
|
|
20
118
|
|
|
21
119
|
| Resource Type | Count | Description |
|
|
@@ -127,28 +225,6 @@ Claude Code will automatically activate the appropriate skill (Vue or React buil
|
|
|
127
225
|
| `get_icon` | Icons | Get icon SVG and framework code |
|
|
128
226
|
| `get_install_info` | Install | Get npm/yarn/pnpm installation commands |
|
|
129
227
|
|
|
130
|
-
### v0.dev Integration (HTTP API)
|
|
131
|
-
|
|
132
|
-
The MCP server can be deployed as an HTTP API for v0.dev integration:
|
|
133
|
-
|
|
134
|
-
```bash
|
|
135
|
-
# Run locally
|
|
136
|
-
DATABASE_PATH=./data/mozaic.db MCP_SERVER_PATH=./dist/index.js AUTH_TOKEN=your-secret-token node dist/main.js
|
|
137
|
-
|
|
138
|
-
# Or deploy with Docker
|
|
139
|
-
docker build -t mozaic-mcp-server .
|
|
140
|
-
docker run -p 3000:3000 -e AUTH_TOKEN=your-secret-token mozaic-mcp-server
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
**Endpoints:**
|
|
144
|
-
- `GET /health` - Health check
|
|
145
|
-
- `POST /mcp` - JSON-RPC endpoint for MCP protocol
|
|
146
|
-
- `POST /mcp/list-tools` - List available tools
|
|
147
|
-
- `POST /mcp/call-tool` - Call a specific tool
|
|
148
|
-
- `GET /api` - Swagger documentation
|
|
149
|
-
|
|
150
|
-
All endpoints require bearer token authentication. See deployment documentation for Dokploy integration.
|
|
151
|
-
|
|
152
228
|
### Configuration
|
|
153
229
|
|
|
154
230
|
Add to your Claude Code or Claude Desktop settings:
|