@adobe/spectrum-design-data-mcp 1.0.11 → 1.0.13
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 +95 -51
- package/README.md +27 -27
- package/package.json +6 -6
- package/src/tools/tokens.js +11 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,52 +1,99 @@
|
|
|
1
1
|
# [**@adobe/spectrum-design-data-mcp**](https://github.com/adobe/spectrum-design-data-mcp)
|
|
2
2
|
|
|
3
|
+
## 1.0.13
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#669](https://github.com/adobe/spectrum-design-data/pull/669) [`ae68c41`](https://github.com/adobe/spectrum-design-data/commit/ae68c412101b32b114d0d56893d1214f5225210a) Thanks [@GarthDB](https://github.com/GarthDB)! - feat(tooling): add renamed property support to token processing tools
|
|
8
|
+
|
|
9
|
+
Updated token processing tools to extract and display the new `renamed` property:
|
|
10
|
+
- **MCP Token Processor**: Extracts `renamed`, `deprecated`, and `deprecated_comment`
|
|
11
|
+
properties in token results
|
|
12
|
+
- **CSV Generator**: Added `renamed`, `deprecated`, and `deprecated_comment` columns
|
|
13
|
+
to CSV export
|
|
14
|
+
- **Diff Generator**: Updated documentation - tool automatically tracks `renamed`
|
|
15
|
+
property changes
|
|
16
|
+
|
|
17
|
+
These updates support the new `renamed` property added to the token schema for
|
|
18
|
+
tracking 1:1 token replacements.
|
|
19
|
+
|
|
20
|
+
- Updated dependencies [[`ae68c41`](https://github.com/adobe/spectrum-design-data/commit/ae68c412101b32b114d0d56893d1214f5225210a)]:
|
|
21
|
+
- @adobe/spectrum-tokens@14.1.0
|
|
22
|
+
|
|
23
|
+
## 1.0.12
|
|
24
|
+
|
|
25
|
+
### Patch Changes
|
|
26
|
+
|
|
27
|
+
- [#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
|
|
28
|
+
spectrum-design-data
|
|
29
|
+
|
|
30
|
+
**Breaking Changes:**
|
|
31
|
+
- JSON Schema `$id` URIs changed (spectrum-tokens → spectrum-design-data)
|
|
32
|
+
- External tools referencing schemas by `$id` must update references
|
|
33
|
+
|
|
34
|
+
**Changes:**
|
|
35
|
+
- Updated all GitHub repository and Pages URLs
|
|
36
|
+
- Updated schema base URIs to maintain consistency
|
|
37
|
+
|
|
38
|
+
**Note:** NPM package names unchanged. GitHub redirects are in place.
|
|
39
|
+
|
|
40
|
+
- Updated dependencies [[`fa28b11`](https://github.com/adobe/spectrum-design-data/commit/fa28b117c6b84776f4ebe9bb281c29e14e0d64b6)]:
|
|
41
|
+
- @adobe/spectrum-tokens@14.0.0
|
|
42
|
+
- @adobe/spectrum-component-api-schemas@6.0.0
|
|
43
|
+
|
|
3
44
|
## 1.0.11
|
|
4
45
|
|
|
5
46
|
### Patch Changes
|
|
6
47
|
|
|
7
|
-
|
|
8
|
-
|
|
48
|
+
- Updated dependencies \[[`ee2ceb5`](https://github.com/adobe/spectrum-design-data/commit/ee2ceb541dea5eb9b5267c861e44bfd804fd33a7)]:
|
|
49
|
+
- @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)
|
|
50
|
+
|
|
51
|
+
## 1.0.10
|
|
52
|
+
|
|
53
|
+
### Patch Changes
|
|
54
|
+
|
|
55
|
+
- Updated dependencies \[[`f64bee3`](https://github.com/adobe/spectrum-design-data/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
|
|
56
|
+
- @adobe/spectrum-tokens@[13.16.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.16.0)
|
|
9
57
|
|
|
10
58
|
## 1.0.10
|
|
11
59
|
|
|
12
60
|
### Patch Changes
|
|
13
61
|
|
|
14
|
-
|
|
15
|
-
|
|
62
|
+
- Updated dependencies \[[`f64bee3`](https://github.com/adobe/spectrum-design-data/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
|
|
63
|
+
- @adobe/spectrum-tokens@[13.16.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.16.0)
|
|
16
64
|
|
|
17
65
|
## 1.0.9
|
|
18
66
|
|
|
19
67
|
### Patch Changes
|
|
20
68
|
|
|
21
|
-
|
|
22
|
-
|
|
69
|
+
- Updated dependencies \[[`a772572`](https://github.com/adobe/spectrum-design-data/commit/a772572de88c54d279c20d7148f6ac91eb941d2a)]:
|
|
70
|
+
- @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
71
|
|
|
24
72
|
## 1.0.8
|
|
25
73
|
|
|
26
74
|
### Patch Changes
|
|
27
75
|
|
|
28
|
-
|
|
29
|
-
|
|
76
|
+
- Updated dependencies \[[`433efdd`](https://github.com/adobe/spectrum-design-data/commit/433efdd18f9b0842ae55acac3cd0fbc1e5e5db58)]:
|
|
77
|
+
- [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)[**@4**](https://github.com/4).0.0
|
|
30
78
|
|
|
31
79
|
## 1.0.7
|
|
32
80
|
|
|
33
81
|
### Patch Changes
|
|
34
82
|
|
|
35
|
-
|
|
36
|
-
|
|
83
|
+
- Updated dependencies \[[`13d9202`](https://github.com/adobe/spectrum-design-data/commit/13d920273c02c78d3748522de6a7c7ee39b39814)]:
|
|
84
|
+
- [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)[**@3**](https://github.com/3).0.0
|
|
37
85
|
|
|
38
86
|
## 1.0.6
|
|
39
87
|
|
|
40
88
|
### Patch Changes
|
|
41
89
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
* Add support section with links to issues and documentation
|
|
90
|
+
- [#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
|
|
91
|
+
- Add multiple MCP configuration options including recommended npx usage
|
|
92
|
+
- Add npm provenance support for enhanced supply-chain security
|
|
93
|
+
- Improve installation section with package integrity verification
|
|
94
|
+
- Add comprehensive troubleshooting section for common issues
|
|
95
|
+
- Add dedicated security section with best practices
|
|
96
|
+
- Add support section with links to issues and documentation
|
|
50
97
|
|
|
51
98
|
These changes align the documentation with modern MCP server standards
|
|
52
99
|
and improve user experience with better configuration options and security features.
|
|
@@ -55,52 +102,51 @@
|
|
|
55
102
|
|
|
56
103
|
### Patch Changes
|
|
57
104
|
|
|
58
|
-
|
|
59
|
-
|
|
105
|
+
- Updated dependencies \[[`1e860c4`](https://github.com/adobe/spectrum-design-data/commit/1e860c4436c58ceca6f4500ea7e24d6d8cdd20c8)]:
|
|
106
|
+
- @adobe/spectrum-tokens@[13.15.1](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.15.1)
|
|
60
107
|
|
|
61
108
|
## 1.0.4
|
|
62
109
|
|
|
63
110
|
### Patch Changes
|
|
64
111
|
|
|
65
|
-
|
|
66
|
-
|
|
112
|
+
- Updated dependencies \[[`3df7197`](https://github.com/adobe/spectrum-design-data/commit/3df7197e7da23c9bb107f7dfcd935b5c62a86041)]:
|
|
113
|
+
- @adobe/spectrum-tokens@[13.15.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.15.0)
|
|
67
114
|
|
|
68
115
|
## 1.0.3
|
|
69
116
|
|
|
70
117
|
### Patch Changes
|
|
71
118
|
|
|
72
|
-
|
|
73
|
-
|
|
119
|
+
- Updated dependencies \[[`b4df84e`](https://github.com/adobe/spectrum-design-data/commit/b4df84e2f2ca246332907f9ddda94438288dd98e)]:
|
|
120
|
+
- @adobe/spectrum-tokens@[13.14.1](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.14.1)
|
|
74
121
|
|
|
75
122
|
## 1.0.2
|
|
76
123
|
|
|
77
124
|
### Patch Changes
|
|
78
125
|
|
|
79
|
-
|
|
80
|
-
|
|
126
|
+
- Updated dependencies \[[`336f672`](https://github.com/adobe/spectrum-design-data/commit/336f67216dfd875f0feb65c10059d9f3fe6dcaf7)]:
|
|
127
|
+
- @adobe/spectrum-tokens@[13.14.0](https://github.com/adobe/spectrum-design-data/releases/tag/@adobe/spectrum-tokens@13.14.0)
|
|
81
128
|
|
|
82
129
|
## 1.0.1
|
|
83
130
|
|
|
84
131
|
### Patch Changes
|
|
85
132
|
|
|
86
|
-
|
|
87
|
-
|
|
133
|
+
- Updated dependencies \[[`163fe7c`](https://github.com/adobe/spectrum-design-data/commit/163fe7c13bb00c639d202195a398126b6c25b58f)]:
|
|
134
|
+
- [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)[**@2**](https://github.com/2).0.0
|
|
88
135
|
|
|
89
136
|
## 1.0.0
|
|
90
137
|
|
|
91
138
|
### Major Changes
|
|
92
139
|
|
|
93
|
-
|
|
140
|
+
- [#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
141
|
|
|
95
142
|
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
143
|
|
|
97
144
|
Features:
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
* Type definitions and schema validation tools
|
|
145
|
+
- Query design tokens by name, type, or category
|
|
146
|
+
- Find tokens for specific component use cases
|
|
147
|
+
- Get component-specific token recommendations
|
|
148
|
+
- Access component API schemas and validation
|
|
149
|
+
- Type definitions and schema validation tools
|
|
104
150
|
|
|
105
151
|
This enables AI assistants to provide intelligent design guidance and automate design token usage across the Spectrum ecosystem.
|
|
106
152
|
|
|
@@ -108,19 +154,17 @@
|
|
|
108
154
|
|
|
109
155
|
### Minor Changes
|
|
110
156
|
|
|
111
|
-
|
|
157
|
+
- Initial release of Spectrum Design Data MCP server
|
|
112
158
|
|
|
113
159
|
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
|
|
160
|
+
- **Design Token Tools**: Query tokens by name, type, or category; get token details and categories
|
|
161
|
+
- **Component Schema Tools**: Search component schemas, validate properties, and explore type definitions
|
|
162
|
+
- **Local Execution**: Runs as a local npm package with no external dependencies or hosting requirements
|
|
163
|
+
- **Extensible Architecture**: Designed to support future design data like component anatomy and patterns
|
|
119
164
|
|
|
120
165
|
The MCP server provides structured access to:
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
* Component API schemas from `@adobe/spectrum-component-api-schemas`
|
|
166
|
+
- All Spectrum design tokens from `@adobe/spectrum-tokens`
|
|
167
|
+
- Component API schemas from `@adobe/spectrum-component-api-schemas`
|
|
124
168
|
|
|
125
169
|
AI assistants can now understand and work with Spectrum design data through standardized MCP tools.
|
|
126
170
|
|
|
@@ -128,10 +172,10 @@
|
|
|
128
172
|
|
|
129
173
|
### Minor Changes
|
|
130
174
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
175
|
+
- Initial release of Spectrum Design Data MCP server
|
|
176
|
+
- Added support for design token querying and retrieval
|
|
177
|
+
- Added support for component schema validation and exploration
|
|
178
|
+
- Implemented token tools: query-tokens, get-token-categories, get-token-details
|
|
179
|
+
- Implemented schema tools: query-component-schemas, get-component-schema, list-components, validate-component-props, get-type-schemas
|
|
180
|
+
- Added CLI interface for starting the MCP server
|
|
181
|
+
- 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.13",
|
|
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.1.0",
|
|
52
|
+
"@adobe/spectrum-component-api-schemas": "6.0.0"
|
|
53
53
|
},
|
|
54
54
|
"devDependencies": {
|
|
55
55
|
"ava": "^6.0.1"
|
package/src/tools/tokens.js
CHANGED
|
@@ -236,6 +236,9 @@ export function createTokenTools() {
|
|
|
236
236
|
schema: token.$schema,
|
|
237
237
|
uuid: token.uuid,
|
|
238
238
|
private: token.private || false,
|
|
239
|
+
deprecated: token.deprecated || false,
|
|
240
|
+
deprecated_comment: token.deprecated_comment,
|
|
241
|
+
renamed: token.renamed,
|
|
239
242
|
relevanceReason: nameMatch ? "name match" : "description match",
|
|
240
243
|
});
|
|
241
244
|
}
|
|
@@ -293,6 +296,9 @@ export function createTokenTools() {
|
|
|
293
296
|
schema: token.$schema,
|
|
294
297
|
uuid: token.uuid,
|
|
295
298
|
private: token.private || false,
|
|
299
|
+
deprecated: token.deprecated || false,
|
|
300
|
+
deprecated_comment: token.deprecated_comment,
|
|
301
|
+
renamed: token.renamed,
|
|
296
302
|
});
|
|
297
303
|
}
|
|
298
304
|
});
|
|
@@ -517,6 +523,11 @@ function processTokens(tokens, fileName, query, type) {
|
|
|
517
523
|
value: value.$value || value.value,
|
|
518
524
|
description: value.$description || value.description,
|
|
519
525
|
extensions: value.$extensions || value.extensions,
|
|
526
|
+
uuid: value.uuid,
|
|
527
|
+
private: value.private || false,
|
|
528
|
+
deprecated: value.deprecated || false,
|
|
529
|
+
deprecated_comment: value.deprecated_comment,
|
|
530
|
+
renamed: value.renamed,
|
|
520
531
|
});
|
|
521
532
|
} else {
|
|
522
533
|
// Recurse into nested objects
|