@adobe/spectrum-design-data-mcp 1.0.11 → 1.0.12
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/CHANGELOG.md +75 -51
- package/README.md +27 -27
- package/package.json +6 -6
package/CHANGELOG.md
CHANGED
|
@@ -1,52 +1,79 @@
|
|
|
1
1
|
# [**@adobe/spectrum-design-data-mcp**](https://github.com/adobe/spectrum-design-data-mcp)
|
|
2
2
|
|
|
3
|
+
## 1.0.12
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#632](https://github.com/adobe/spectrum-design-data/pull/632) [`fa28b11`](https://github.com/adobe/spectrum-design-data/commit/fa28b117c6b84776f4ebe9bb281c29e14e0d64b6) Thanks [@GarthDB](https://github.com/GarthDB)! - BREAKING CHANGE: Repository renamed from spectrum-tokens to
|
|
8
|
+
spectrum-design-data
|
|
9
|
+
|
|
10
|
+
**Breaking Changes:**
|
|
11
|
+
- JSON Schema `$id` URIs changed (spectrum-tokens → spectrum-design-data)
|
|
12
|
+
- External tools referencing schemas by `$id` must update references
|
|
13
|
+
|
|
14
|
+
**Changes:**
|
|
15
|
+
- Updated all GitHub repository and Pages URLs
|
|
16
|
+
- Updated schema base URIs to maintain consistency
|
|
17
|
+
|
|
18
|
+
**Note:** NPM package names unchanged. GitHub redirects are in place.
|
|
19
|
+
|
|
20
|
+
- Updated dependencies [[`fa28b11`](https://github.com/adobe/spectrum-design-data/commit/fa28b117c6b84776f4ebe9bb281c29e14e0d64b6)]:
|
|
21
|
+
- @adobe/spectrum-tokens@14.0.0
|
|
22
|
+
- @adobe/spectrum-component-api-schemas@6.0.0
|
|
23
|
+
|
|
3
24
|
## 1.0.11
|
|
4
25
|
|
|
5
26
|
### Patch Changes
|
|
6
27
|
|
|
7
|
-
|
|
8
|
-
|
|
28
|
+
- Updated dependencies \[[`ee2ceb5`](https://github.com/adobe/spectrum-design-data/commit/ee2ceb541dea5eb9b5267c861e44bfd804fd33a7)]:
|
|
29
|
+
- @adobe/spectrum-component-api-schemas@[5.0.1](https://github.com/adobe/spectrum-component-api-schemas/releases/tag/@adobe/spectrum-component-api-schemas@5.0.1)
|
|
9
30
|
|
|
10
31
|
## 1.0.10
|
|
11
32
|
|
|
12
33
|
### Patch Changes
|
|
13
34
|
|
|
14
|
-
|
|
15
|
-
|
|
35
|
+
- Updated dependencies \[[`f64bee3`](https://github.com/adobe/spectrum-design-data/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
|
|
36
|
+
- @adobe/spectrum-tokens@[13.16.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.16.0)
|
|
37
|
+
|
|
38
|
+
## 1.0.10
|
|
39
|
+
|
|
40
|
+
### Patch Changes
|
|
41
|
+
|
|
42
|
+
- Updated dependencies \[[`f64bee3`](https://github.com/adobe/spectrum-design-data/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
|
|
43
|
+
- @adobe/spectrum-tokens@[13.16.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.16.0)
|
|
16
44
|
|
|
17
45
|
## 1.0.9
|
|
18
46
|
|
|
19
47
|
### Patch Changes
|
|
20
48
|
|
|
21
|
-
|
|
22
|
-
|
|
49
|
+
- Updated dependencies \[[`a772572`](https://github.com/adobe/spectrum-design-data/commit/a772572de88c54d279c20d7148f6ac91eb941d2a)]:
|
|
50
|
+
- @adobe/spectrum-component-api-schemas@[5.0.0](https://github.com/adobe/spectrum-component-api-schemas/releases/tag/@adobe/spectrum-component-api-schemas@5.0.0)
|
|
23
51
|
|
|
24
52
|
## 1.0.8
|
|
25
53
|
|
|
26
54
|
### Patch Changes
|
|
27
55
|
|
|
28
|
-
|
|
29
|
-
|
|
56
|
+
- Updated dependencies \[[`433efdd`](https://github.com/adobe/spectrum-design-data/commit/433efdd18f9b0842ae55acac3cd0fbc1e5e5db58)]:
|
|
57
|
+
- [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)[**@4**](https://github.com/4).0.0
|
|
30
58
|
|
|
31
59
|
## 1.0.7
|
|
32
60
|
|
|
33
61
|
### Patch Changes
|
|
34
62
|
|
|
35
|
-
|
|
36
|
-
|
|
63
|
+
- Updated dependencies \[[`13d9202`](https://github.com/adobe/spectrum-design-data/commit/13d920273c02c78d3748522de6a7c7ee39b39814)]:
|
|
64
|
+
- [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)[**@3**](https://github.com/3).0.0
|
|
37
65
|
|
|
38
66
|
## 1.0.6
|
|
39
67
|
|
|
40
68
|
### Patch Changes
|
|
41
69
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
* Add support section with links to issues and documentation
|
|
70
|
+
- [#595](https://github.com/adobe/spectrum-design-data/pull/595) [`53bc11e`](https://github.com/adobe/spectrum-design-data/commit/53bc11e1bfcc3a839cfc5dfbd63f59cc5e87a1c3) Thanks [@GarthDB](https://github.com/GarthDB)! - Enhanced documentation with security and configuration improvements
|
|
71
|
+
- Add multiple MCP configuration options including recommended npx usage
|
|
72
|
+
- Add npm provenance support for enhanced supply-chain security
|
|
73
|
+
- Improve installation section with package integrity verification
|
|
74
|
+
- Add comprehensive troubleshooting section for common issues
|
|
75
|
+
- Add dedicated security section with best practices
|
|
76
|
+
- Add support section with links to issues and documentation
|
|
50
77
|
|
|
51
78
|
These changes align the documentation with modern MCP server standards
|
|
52
79
|
and improve user experience with better configuration options and security features.
|
|
@@ -55,52 +82,51 @@
|
|
|
55
82
|
|
|
56
83
|
### Patch Changes
|
|
57
84
|
|
|
58
|
-
|
|
59
|
-
|
|
85
|
+
- Updated dependencies \[[`1e860c4`](https://github.com/adobe/spectrum-design-data/commit/1e860c4436c58ceca6f4500ea7e24d6d8cdd20c8)]:
|
|
86
|
+
- @adobe/spectrum-tokens@[13.15.1](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.15.1)
|
|
60
87
|
|
|
61
88
|
## 1.0.4
|
|
62
89
|
|
|
63
90
|
### Patch Changes
|
|
64
91
|
|
|
65
|
-
|
|
66
|
-
|
|
92
|
+
- Updated dependencies \[[`3df7197`](https://github.com/adobe/spectrum-design-data/commit/3df7197e7da23c9bb107f7dfcd935b5c62a86041)]:
|
|
93
|
+
- @adobe/spectrum-tokens@[13.15.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.15.0)
|
|
67
94
|
|
|
68
95
|
## 1.0.3
|
|
69
96
|
|
|
70
97
|
### Patch Changes
|
|
71
98
|
|
|
72
|
-
|
|
73
|
-
|
|
99
|
+
- Updated dependencies \[[`b4df84e`](https://github.com/adobe/spectrum-design-data/commit/b4df84e2f2ca246332907f9ddda94438288dd98e)]:
|
|
100
|
+
- @adobe/spectrum-tokens@[13.14.1](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.14.1)
|
|
74
101
|
|
|
75
102
|
## 1.0.2
|
|
76
103
|
|
|
77
104
|
### Patch Changes
|
|
78
105
|
|
|
79
|
-
|
|
80
|
-
|
|
106
|
+
- Updated dependencies \[[`336f672`](https://github.com/adobe/spectrum-design-data/commit/336f67216dfd875f0feb65c10059d9f3fe6dcaf7)]:
|
|
107
|
+
- @adobe/spectrum-tokens@[13.14.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.14.0)
|
|
81
108
|
|
|
82
109
|
## 1.0.1
|
|
83
110
|
|
|
84
111
|
### Patch Changes
|
|
85
112
|
|
|
86
|
-
|
|
87
|
-
|
|
113
|
+
- Updated dependencies \[[`163fe7c`](https://github.com/adobe/spectrum-design-data/commit/163fe7c13bb00c639d202195a398126b6c25b58f)]:
|
|
114
|
+
- [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)[**@2**](https://github.com/2).0.0
|
|
88
115
|
|
|
89
116
|
## 1.0.0
|
|
90
117
|
|
|
91
118
|
### Major Changes
|
|
92
119
|
|
|
93
|
-
|
|
120
|
+
- [#568](https://github.com/adobe/spectrum-design-data/pull/568) [`34028ea`](https://github.com/adobe/spectrum-design-data/commit/34028eaf2ba3940baa8044fda2655adc6153fb97) Thanks [@GarthDB](https://github.com/GarthDB)! - Initial release of Spectrum Design Data MCP server
|
|
94
121
|
|
|
95
122
|
This is the first release of the Model Context Protocol server that provides AI tools with structured access to Adobe Spectrum design system data, including design tokens and component API schemas.
|
|
96
123
|
|
|
97
124
|
Features:
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
* Type definitions and schema validation tools
|
|
125
|
+
- Query design tokens by name, type, or category
|
|
126
|
+
- Find tokens for specific component use cases
|
|
127
|
+
- Get component-specific token recommendations
|
|
128
|
+
- Access component API schemas and validation
|
|
129
|
+
- Type definitions and schema validation tools
|
|
104
130
|
|
|
105
131
|
This enables AI assistants to provide intelligent design guidance and automate design token usage across the Spectrum ecosystem.
|
|
106
132
|
|
|
@@ -108,19 +134,17 @@
|
|
|
108
134
|
|
|
109
135
|
### Minor Changes
|
|
110
136
|
|
|
111
|
-
|
|
137
|
+
- Initial release of Spectrum Design Data MCP server
|
|
112
138
|
|
|
113
139
|
This new package provides a Model Context Protocol (MCP) server that enables AI tools to query and interact with Spectrum design system data. Features include:
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
* **Extensible Architecture**: Designed to support future design data like component anatomy and patterns
|
|
140
|
+
- **Design Token Tools**: Query tokens by name, type, or category; get token details and categories
|
|
141
|
+
- **Component Schema Tools**: Search component schemas, validate properties, and explore type definitions
|
|
142
|
+
- **Local Execution**: Runs as a local npm package with no external dependencies or hosting requirements
|
|
143
|
+
- **Extensible Architecture**: Designed to support future design data like component anatomy and patterns
|
|
119
144
|
|
|
120
145
|
The MCP server provides structured access to:
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
* Component API schemas from `@adobe/spectrum-component-api-schemas`
|
|
146
|
+
- All Spectrum design tokens from `@adobe/spectrum-tokens`
|
|
147
|
+
- Component API schemas from `@adobe/spectrum-component-api-schemas`
|
|
124
148
|
|
|
125
149
|
AI assistants can now understand and work with Spectrum design data through standardized MCP tools.
|
|
126
150
|
|
|
@@ -128,10 +152,10 @@
|
|
|
128
152
|
|
|
129
153
|
### Minor Changes
|
|
130
154
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
155
|
+
- Initial release of Spectrum Design Data MCP server
|
|
156
|
+
- Added support for design token querying and retrieval
|
|
157
|
+
- Added support for component schema validation and exploration
|
|
158
|
+
- Implemented token tools: query-tokens, get-token-categories, get-token-details
|
|
159
|
+
- Implemented schema tools: query-component-schemas, get-component-schema, list-components, validate-component-props, get-type-schemas
|
|
160
|
+
- Added CLI interface for starting the MCP server
|
|
161
|
+
- Added comprehensive test coverage
|
package/README.md
CHANGED
|
@@ -6,13 +6,13 @@ A Model Context Protocol (MCP) server that provides AI tools with structured acc
|
|
|
6
6
|
|
|
7
7
|
This MCP server enables AI assistants to query and interact with Spectrum design data through a standardized protocol. It provides access to:
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
* **Design Tokens**: Color palettes, typography, layout tokens, and semantic tokens
|
|
10
|
+
* **Component Schemas**: API definitions and validation schemas for Spectrum components
|
|
11
|
+
* **Future**: Component anatomy, design patterns, and guidelines
|
|
12
12
|
|
|
13
13
|
## Prerequisites
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
* **Node.js 20+**
|
|
16
16
|
|
|
17
17
|
## Installation
|
|
18
18
|
|
|
@@ -31,7 +31,7 @@ npm audit signatures
|
|
|
31
31
|
Or clone and run locally:
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
git clone https://github.com/adobe/spectrum-
|
|
34
|
+
git clone https://github.com/adobe/spectrum-design-data.git
|
|
35
35
|
cd spectrum-tokens/tools/spectrum-design-data-mcp
|
|
36
36
|
pnpm install
|
|
37
37
|
```
|
|
@@ -54,20 +54,20 @@ The server runs locally and communicates via stdio with MCP-compatible AI client
|
|
|
54
54
|
|
|
55
55
|
#### Token Tools
|
|
56
56
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
57
|
+
* **`query-tokens`**: Search and retrieve design tokens by name, type, or category
|
|
58
|
+
* **`find-tokens-by-use-case`** ⭐: Find appropriate tokens for specific component use cases (e.g., "button background", "text color", "error state")
|
|
59
|
+
* **`get-component-tokens`** ⭐: Get all tokens related to a specific component type
|
|
60
|
+
* **`get-design-recommendations`** ⭐: Get token recommendations for design decisions and component states
|
|
61
|
+
* **`get-token-categories`**: List all available token categories
|
|
62
|
+
* **`get-token-details`**: Get detailed information about a specific token
|
|
63
63
|
|
|
64
64
|
#### Schema Tools
|
|
65
65
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
66
|
+
* **`query-component-schemas`**: Search component API schemas
|
|
67
|
+
* **`get-component-schema`**: Get the complete schema for a specific component
|
|
68
|
+
* **`list-components`**: List all available components with schemas
|
|
69
|
+
* **`validate-component-props`**: Validate component properties against schemas
|
|
70
|
+
* **`get-type-schemas`**: Get type definitions used in schemas
|
|
71
71
|
|
|
72
72
|
## Configuration
|
|
73
73
|
|
|
@@ -253,7 +253,7 @@ npm audit
|
|
|
253
253
|
### Building from Source
|
|
254
254
|
|
|
255
255
|
```bash
|
|
256
|
-
git clone https://github.com/adobe/spectrum-
|
|
256
|
+
git clone https://github.com/adobe/spectrum-design-data.git
|
|
257
257
|
cd spectrum-tokens
|
|
258
258
|
pnpm install
|
|
259
259
|
cd tools/spectrum-design-data-mcp
|
|
@@ -283,16 +283,16 @@ src/
|
|
|
283
283
|
|
|
284
284
|
### Supply Chain Security
|
|
285
285
|
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
286
|
+
* **🔐 NPM Provenance**: Published with npm provenance attestations for verifiable builds
|
|
287
|
+
* **🛡️ Security Audits**: Regular dependency security audits
|
|
288
|
+
* **📦 Verified Packages**: All dependencies are audited and verified
|
|
289
289
|
|
|
290
290
|
### Best Practices
|
|
291
291
|
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
292
|
+
* Always verify package integrity using `npm audit signatures`
|
|
293
|
+
* Keep the package updated to the latest version
|
|
294
|
+
* Use npx for the most secure and up-to-date execution
|
|
295
|
+
* Report security issues through the [GitHub security advisory](https://github.com/adobe/spectrum-design-data/security/advisories)
|
|
296
296
|
|
|
297
297
|
## License
|
|
298
298
|
|
|
@@ -304,6 +304,6 @@ This project is part of the Spectrum Design System. Please see the main [contrib
|
|
|
304
304
|
|
|
305
305
|
## Support
|
|
306
306
|
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
307
|
+
* Create an [issue](https://github.com/adobe/spectrum-design-data/issues) for bug reports or feature requests
|
|
308
|
+
* Check the [documentation](https://github.com/adobe/spectrum-design-data/tree/main/tools/spectrum-design-data-mcp) for detailed guides
|
|
309
|
+
* Review [existing issues](https://github.com/adobe/spectrum-design-data/issues?q=label%3Amcp) for solutions
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@adobe/spectrum-design-data-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.12",
|
|
4
4
|
"description": "Model Context Protocol server for Spectrum design data including tokens, schemas, and component anatomy",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
@@ -31,15 +31,15 @@
|
|
|
31
31
|
},
|
|
32
32
|
"repository": {
|
|
33
33
|
"type": "git",
|
|
34
|
-
"url": "git+https://github.com/adobe/spectrum-
|
|
34
|
+
"url": "git+https://github.com/adobe/spectrum-design-data.git",
|
|
35
35
|
"directory": "tools/spectrum-design-data-mcp"
|
|
36
36
|
},
|
|
37
37
|
"author": "Garth Braithwaite <garthdb@gmail.com> (http://garthdb.com/)",
|
|
38
38
|
"license": "Apache-2.0",
|
|
39
39
|
"bugs": {
|
|
40
|
-
"url": "https://github.com/adobe/spectrum-
|
|
40
|
+
"url": "https://github.com/adobe/spectrum-design-data/issues"
|
|
41
41
|
},
|
|
42
|
-
"homepage": "https://github.com/adobe/spectrum-
|
|
42
|
+
"homepage": "https://github.com/adobe/spectrum-design-data/tree/main/tools/spectrum-design-data-mcp#readme",
|
|
43
43
|
"publishConfig": {
|
|
44
44
|
"access": "public",
|
|
45
45
|
"registry": "https://registry.npmjs.org/",
|
|
@@ -48,8 +48,8 @@
|
|
|
48
48
|
"dependencies": {
|
|
49
49
|
"@modelcontextprotocol/sdk": "^0.5.0",
|
|
50
50
|
"commander": "^13.1.0",
|
|
51
|
-
"@adobe/spectrum-tokens": "
|
|
52
|
-
"@adobe/spectrum-component-api-schemas": "
|
|
51
|
+
"@adobe/spectrum-tokens": "14.0.0",
|
|
52
|
+
"@adobe/spectrum-component-api-schemas": "6.0.0"
|
|
53
53
|
},
|
|
54
54
|
"devDependencies": {
|
|
55
55
|
"ava": "^6.0.1"
|