@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.
Files changed (3) hide show
  1. package/CHANGELOG.md +75 -51
  2. package/README.md +27 -27
  3. 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
- * Updated dependencies \[[`ee2ceb5`](https://github.com/adobe/spectrum-tokens/commit/ee2ceb541dea5eb9b5267c861e44bfd804fd33a7)]:
8
- * [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)@5.0.1
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
- * Updated dependencies \[[`f64bee3`](https://github.com/adobe/spectrum-tokens/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
15
- * [**@adobe/spectrum-tokens**](https://github.com/adobe/spectrum-tokens)@13.16.0
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
- * Updated dependencies \[[`a772572`](https://github.com/adobe/spectrum-tokens/commit/a772572de88c54d279c20d7148f6ac91eb941d2a)]:
22
- * [**@adobe/spectrum-component-api-schemas**](https://github.com/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)
23
51
 
24
52
  ## 1.0.8
25
53
 
26
54
  ### Patch Changes
27
55
 
28
- * Updated dependencies \[[`433efdd`](https://github.com/adobe/spectrum-tokens/commit/433efdd18f9b0842ae55acac3cd0fbc1e5e5db58)]:
29
- * [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)@4.0.0
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
- * Updated dependencies \[[`13d9202`](https://github.com/adobe/spectrum-tokens/commit/13d920273c02c78d3748522de6a7c7ee39b39814)]:
36
- * [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)@3.0.0
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
- * [#595](https://github.com/adobe/spectrum-tokens/pull/595) [`53bc11e`](https://github.com/adobe/spectrum-tokens/commit/53bc11e1bfcc3a839cfc5dfbd63f59cc5e87a1c3) Thanks [@GarthDB](https://github.com/GarthDB)! - Enhanced documentation with security and configuration improvements
43
-
44
- * Add multiple MCP configuration options including recommended npx usage
45
- * Add npm provenance support for enhanced supply-chain security
46
- * Improve installation section with package integrity verification
47
- * Add comprehensive troubleshooting section for common issues
48
- * Add dedicated security section with best practices
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
- * Updated dependencies \[[`1e860c4`](https://github.com/adobe/spectrum-tokens/commit/1e860c4436c58ceca6f4500ea7e24d6d8cdd20c8)]:
59
- * [**@adobe/spectrum-tokens**](https://github.com/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)
60
87
 
61
88
  ## 1.0.4
62
89
 
63
90
  ### Patch Changes
64
91
 
65
- * Updated dependencies \[[`3df7197`](https://github.com/adobe/spectrum-tokens/commit/3df7197e7da23c9bb107f7dfcd935b5c62a86041)]:
66
- * [**@adobe/spectrum-tokens**](https://github.com/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)
67
94
 
68
95
  ## 1.0.3
69
96
 
70
97
  ### Patch Changes
71
98
 
72
- * Updated dependencies \[[`b4df84e`](https://github.com/adobe/spectrum-tokens/commit/b4df84e2f2ca246332907f9ddda94438288dd98e)]:
73
- * [**@adobe/spectrum-tokens**](https://github.com/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)
74
101
 
75
102
  ## 1.0.2
76
103
 
77
104
  ### Patch Changes
78
105
 
79
- * Updated dependencies \[[`336f672`](https://github.com/adobe/spectrum-tokens/commit/336f67216dfd875f0feb65c10059d9f3fe6dcaf7)]:
80
- * [**@adobe/spectrum-tokens**](https://github.com/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)
81
108
 
82
109
  ## 1.0.1
83
110
 
84
111
  ### Patch Changes
85
112
 
86
- * Updated dependencies \[[`163fe7c`](https://github.com/adobe/spectrum-tokens/commit/163fe7c13bb00c639d202195a398126b6c25b58f)]:
87
- * [**@adobe/spectrum-component-api-schemas**](https://github.com/adobe/spectrum-component-api-schemas)@2.0.0
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
- * [#568](https://github.com/adobe/spectrum-tokens/pull/568) [`34028ea`](https://github.com/adobe/spectrum-tokens/commit/34028eaf2ba3940baa8044fda2655adc6153fb97) Thanks [@GarthDB](https://github.com/GarthDB)! - Initial release of Spectrum Design Data MCP server
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
- * Query design tokens by name, type, or category
100
- * Find tokens for specific component use cases
101
- * Get component-specific token recommendations
102
- * Access component API schemas and validation
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
- * Initial release of Spectrum Design Data MCP server
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
- * **Design Token Tools**: Query tokens by name, type, or category; get token details and categories
116
- * **Component Schema Tools**: Search component schemas, validate properties, and explore type definitions
117
- * **Local Execution**: Runs as a local npm package with no external dependencies or hosting requirements
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
- * All Spectrum design tokens from `@adobe/spectrum-tokens`
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
- * Initial release of Spectrum Design Data MCP server
132
- * Added support for design token querying and retrieval
133
- * Added support for component schema validation and exploration
134
- * Implemented token tools: query-tokens, get-token-categories, get-token-details
135
- * Implemented schema tools: query-component-schemas, get-component-schema, list-components, validate-component-props, get-type-schemas
136
- * Added CLI interface for starting the MCP server
137
- * Added comprehensive test coverage
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
- - **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
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
- - **Node.js 20+**
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-tokens.git
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
- - **`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
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
- - **`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
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-tokens.git
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
- - **🔐 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
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
- - 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-tokens/security/advisories)
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
- - Create an [issue](https://github.com/adobe/spectrum-tokens/issues) for bug reports or feature requests
308
- - Check the [documentation](https://github.com/adobe/spectrum-tokens/tree/main/tools/spectrum-design-data-mcp) for detailed guides
309
- - Review [existing issues](https://github.com/adobe/spectrum-tokens/issues?q=label%3Amcp) for solutions
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.11",
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-tokens.git",
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-tokens/issues"
40
+ "url": "https://github.com/adobe/spectrum-design-data/issues"
41
41
  },
42
- "homepage": "https://github.com/adobe/spectrum-tokens/tree/main/tools/spectrum-design-data-mcp#readme",
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": "13.16.0",
52
- "@adobe/spectrum-component-api-schemas": "5.0.1"
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"