@adobe/spectrum-design-data-mcp 1.0.10 → 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 +56 -21
- package/README.md +27 -27
- package/package.json +6 -6
package/CHANGELOG.md
CHANGED
|
@@ -1,38 +1,73 @@
|
|
|
1
|
-
#
|
|
1
|
+
# [**@adobe/spectrum-design-data-mcp**](https://github.com/adobe/spectrum-design-data-mcp)
|
|
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
|
+
|
|
24
|
+
## 1.0.11
|
|
25
|
+
|
|
26
|
+
### Patch Changes
|
|
27
|
+
|
|
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)
|
|
30
|
+
|
|
31
|
+
## 1.0.10
|
|
32
|
+
|
|
33
|
+
### Patch Changes
|
|
34
|
+
|
|
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)
|
|
2
37
|
|
|
3
38
|
## 1.0.10
|
|
4
39
|
|
|
5
40
|
### Patch Changes
|
|
6
41
|
|
|
7
|
-
- Updated dependencies [[`f64bee3`](https://github.com/adobe/spectrum-
|
|
8
|
-
- @adobe/spectrum-tokens@13.16.0
|
|
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)
|
|
9
44
|
|
|
10
45
|
## 1.0.9
|
|
11
46
|
|
|
12
47
|
### Patch Changes
|
|
13
48
|
|
|
14
|
-
- Updated dependencies [[`a772572`](https://github.com/adobe/spectrum-
|
|
15
|
-
- @adobe/spectrum-component-api-schemas@5.0.0
|
|
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)
|
|
16
51
|
|
|
17
52
|
## 1.0.8
|
|
18
53
|
|
|
19
54
|
### Patch Changes
|
|
20
55
|
|
|
21
|
-
- Updated dependencies [[`433efdd`](https://github.com/adobe/spectrum-
|
|
22
|
-
-
|
|
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
|
|
23
58
|
|
|
24
59
|
## 1.0.7
|
|
25
60
|
|
|
26
61
|
### Patch Changes
|
|
27
62
|
|
|
28
|
-
- Updated dependencies [[`13d9202`](https://github.com/adobe/spectrum-
|
|
29
|
-
-
|
|
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
|
|
30
65
|
|
|
31
66
|
## 1.0.6
|
|
32
67
|
|
|
33
68
|
### Patch Changes
|
|
34
69
|
|
|
35
|
-
- [#595](https://github.com/adobe/spectrum-
|
|
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
|
|
36
71
|
- Add multiple MCP configuration options including recommended npx usage
|
|
37
72
|
- Add npm provenance support for enhanced supply-chain security
|
|
38
73
|
- Improve installation section with package integrity verification
|
|
@@ -47,42 +82,42 @@
|
|
|
47
82
|
|
|
48
83
|
### Patch Changes
|
|
49
84
|
|
|
50
|
-
- Updated dependencies [[`1e860c4`](https://github.com/adobe/spectrum-
|
|
51
|
-
- @adobe/spectrum-tokens@13.15.1
|
|
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)
|
|
52
87
|
|
|
53
88
|
## 1.0.4
|
|
54
89
|
|
|
55
90
|
### Patch Changes
|
|
56
91
|
|
|
57
|
-
- Updated dependencies [[`3df7197`](https://github.com/adobe/spectrum-
|
|
58
|
-
- @adobe/spectrum-tokens@13.15.0
|
|
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)
|
|
59
94
|
|
|
60
95
|
## 1.0.3
|
|
61
96
|
|
|
62
97
|
### Patch Changes
|
|
63
98
|
|
|
64
|
-
- Updated dependencies [[`b4df84e`](https://github.com/adobe/spectrum-
|
|
65
|
-
- @adobe/spectrum-tokens@13.14.1
|
|
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)
|
|
66
101
|
|
|
67
102
|
## 1.0.2
|
|
68
103
|
|
|
69
104
|
### Patch Changes
|
|
70
105
|
|
|
71
|
-
- Updated dependencies [[`336f672`](https://github.com/adobe/spectrum-
|
|
72
|
-
- @adobe/spectrum-tokens@13.14.0
|
|
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)
|
|
73
108
|
|
|
74
109
|
## 1.0.1
|
|
75
110
|
|
|
76
111
|
### Patch Changes
|
|
77
112
|
|
|
78
|
-
- Updated dependencies [[`163fe7c`](https://github.com/adobe/spectrum-
|
|
79
|
-
-
|
|
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
|
|
80
115
|
|
|
81
116
|
## 1.0.0
|
|
82
117
|
|
|
83
118
|
### Major Changes
|
|
84
119
|
|
|
85
|
-
- [#568](https://github.com/adobe/spectrum-
|
|
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
|
|
86
121
|
|
|
87
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.
|
|
88
123
|
|
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"
|