@atlaskit/ads-mcp 0.17.1 → 0.17.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @atlaskit/ads-mcp
 
+## 0.17.3
+
+### Patch Changes
+
+- [`3462e31664c27`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/3462e31664c27) -
+  Auto-generate with new examples from dropdown, select, and label
+
+## 0.17.2
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 0.17.1
 
 ### Patch Changes

package/README.md

@@ -5,6 +5,15 @@ Current state: Early Access
 The official Model Context Protocol (MCP) server for the Atlassian Design System. This server
 provides tools to access design tokens, icons, and components/primitives programmatically.
 
+**New: Remote MCP Server** A hosted version of the ADS MCP server is now available at
+`https://mcp.atlassian.com/v1/ads/public/mcp`. Simply point your MCP client to this URL to get
+started. See the [Usage](#usage) section for per-IDE configuration examples.
+
+Or, just click one of the buttons below to easily add the server to Cursor or VS Code.
+
+[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_ads--mcp-000000?style=for-the-badge&logo=cursor&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22ads-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.atlassian.com%2Fv1%2Fads%2Fpublic%2Fmcp%22%7D)
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_ads--mcp-0098FF?style=for-the-badge&logo=githubcopilot&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22ads-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.atlassian.com%2Fv1%2Fads%2Fpublic%2Fmcp%22%7D)
+
 **New: Accessibility Analysis & Guidance** The server now includes comprehensive accessibility tools
 to help ensure your interfaces are accessible to all users.
 
@@ -19,10 +28,18 @@ to help ensure your interfaces are accessible to all users.
   - [For AFM Users (internal Atlassians only)](#for-afm-users-internal-atlassians-only)
   - [For non-AFM Users](#for-non-afm-users)
     - [Cursor IDE](#cursor-ide)
+      - [Local (stdio)](#local-stdio)
+      - [Remote](#remote)
     - [Visual Studio Code](#visual-studio-code)
       - [Github Copilot](#github-copilot)
+        - [Local (stdio)](#local-stdio-1)
+        - [Remote](#remote-1)
       - [Codelassian](#codelassian)
+        - [Local (stdio)](#local-stdio-2)
+        - [Remote](#remote-2)
     - [Rovodev](#rovodev)
+      - [Local (stdio)](#local-stdio-3)
+      - [Remote](#remote-3)
     - [MCP Plugin for Atlas CLI](#mcp-plugin-for-atlas-cli)
   - [Environment Variables](#environment-variables)
 - [Analytics](#analytics)
@@ -142,6 +159,8 @@ ads-mcp.
 
 #### Cursor IDE
 
+##### Local (stdio)
+
 Add the following entry to your `mcp.json` file (located at `~/.cursor/mcp.json` for user-level or
 `.cursor/mcp.json` in your workspace):
 
@@ -159,10 +178,28 @@ Add the following entry to your `mcp.json` file (located at `~/.cursor/mcp.json`
 }
 ```
 
+##### Remote
+
+Click
+[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_ads--mcp-000000?style=for-the-badge&logo=cursor&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22ads-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.atlassian.com%2Fv1%2Fads%2Fpublic%2Fmcp%22%7D)
+to add or add the following to the same `mcp.json` file:
+
+```json
+{
+	"mcpServers": {
+		"ads-mcp": {
+			"url": "https://mcp.atlassian.com/v1/ads/public/mcp"
+		}
+	}
+}
+```
+
 #### Visual Studio Code
 
 ##### Github Copilot
 
+###### Local (stdio)
+
 Add the following entry to your `mcp.json` file (located at
 `~/Library/Application Support/Code/User/mcp.json` for user-level or `.vscode/mcp.json` in your
 workspace):
@@ -182,8 +219,27 @@ workspace):
 }
 ```
 
+###### Remote
+
+Click
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_ads--mcp-0098FF?style=for-the-badge&logo=githubcopilot&logoColor=ffffff)](vscode:mcp/install?%7B%22name%22%3A%22ads-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.atlassian.com%2Fv1%2Fads%2Fpublic%2Fmcp%22%7D)
+or add the following to the same `mcp.json` file:
+
+```json
+{
+	"servers": {
+		"ads-mcp": {
+			"type": "http",
+			"url": "https://mcp.atlassian.com/v1/ads/public/mcp"
+		}
+	}
+}
+```
+
 ##### Codelassian
 
+###### Local (stdio)
+
 Add the following entry to your `mcp.json` file (located at `~/.codelassian/mcp.json` for user-level
 or `.codelassian/mcp.json` in your workspace):
 
@@ -201,8 +257,26 @@ or `.codelassian/mcp.json` in your workspace):
 }
 ```
 
+###### Remote
+
+No local installation required. Add the following to the same `mcp.json` file:
+
+```json
+{
+	"mcpServers": {
+		"ads-mcp": {
+			"type": "streamableHttp",
+			"url": "https://mcp.atlassian.com/v1/ads/public/mcp",
+			"disabled": false
+		}
+	}
+}
+```
+
 #### Rovodev
 
+##### Local (stdio)
+
 Add the following entry to your `mcp.json` file (located at `~/.rovodev/mcp.json` for user-level or
 `mcp.json` in your workspace):
 
@@ -226,6 +300,20 @@ Add the following entry to your `mcp.json` file (located at `~/.rovodev/mcp.json
 > terminating the process if it becomes unresponsive. Adjust this value as needed for your
 > environment or workflow.
 
+##### Remote
+
+No local installation required. Add the following to the same `mcp.json` file:
+
+```json
+{
+	"mcpServers": {
+		"ads-mcp": {
+			"url": "https://mcp.atlassian.com/v1/ads/public/mcp"
+		}
+	}
+}
+```
+
 #### MCP Plugin for Atlas CLI
 
 Atlas CLI provides a plugin for managing MCP servers, including listing available servers from a

package/dist/cjs/index.js

@@ -11,7 +11,6 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _index = require("@modelcontextprotocol/sdk/server/index.js");
 var _stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 var _types = require("@modelcontextprotocol/sdk/types.js");
-var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _analytics = require("./helpers/analytics");
 var _validation = require("./helpers/validation");
 var _instructions = require("./instructions");
@@ -21,9 +20,7 @@ var _getAllIcons = require("./tools/get-all-icons");
 var _getAllTokens = require("./tools/get-all-tokens");
 var _getComponents = require("./tools/get-components");
 var _getGuidelines = require("./tools/get-guidelines");
-var _getIcons = require("./tools/get-icons");
 var _getLintRules = require("./tools/get-lint-rules");
-var _getTokens = require("./tools/get-tokens");
 var _i18nConversion = require("./tools/i18n-conversion");
 var _migrationGuides = require("./tools/migration-guides");
 var _plan = require("./tools/plan");
@@ -65,7 +62,8 @@ var generateLogger = function generateLogger(level) {
   };
 };
 var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
-  var baseTools = (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _analyzeA11y.listAnalyzeA11yTool.name, {
+  var _baseTools;
+  var baseTools = (_baseTools = {}, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)(_baseTools, _analyzeA11y.listAnalyzeA11yTool.name, {
     handler: _analyzeA11y.analyzeA11yTool,
     inputSchema: _analyzeA11y.analyzeA11yInputSchema,
     tool: _analyzeA11y.listAnalyzeA11yTool
@@ -97,42 +95,23 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _i18nConversion.i18nConversionTool,
     inputSchema: _i18nConversion.i18nConversionInputSchema,
     tool: _i18nConversion.listI18nConversionTool
-  });
-
-  // Conditionally add token and icon tools based on feature flag
-  if ((0, _platformFeatureFlags.fg)('design_system_mcp_structured_content')) {
-    baseTools[_getTokens.listGetTokensTool.name] = {
-      handler: _getTokens.getTokensTool,
-      inputSchema: _getTokens.getTokensInputSchema,
-      tool: _getTokens.listGetTokensTool
-    };
-    baseTools[_getIcons.listGetIconsTool.name] = {
-      handler: _getIcons.getIconsTool,
-      inputSchema: _getIcons.getIconsInputSchema,
-      tool: _getIcons.listGetIconsTool
-    };
-    baseTools[_getLintRules.listGetLintRulesTool.name] = {
-      handler: _getLintRules.getLintRulesTool,
-      inputSchema: _getLintRules.getLintRulesInputSchema,
-      tool: _getLintRules.listGetLintRulesTool
-    };
-    baseTools[_getGuidelines.listGetGuidelinesTool.name] = {
-      handler: _getGuidelines.getGuidelinesTool,
-      inputSchema: _getGuidelines.getGuidelinesInputSchema,
-      tool: _getGuidelines.listGetGuidelinesTool
-    };
-  } else {
-    baseTools[_getAllTokens.listGetAllTokensTool.name] = {
-      handler: _getAllTokens.getAllTokensTool,
-      inputSchema: null,
-      tool: _getAllTokens.listGetAllTokensTool
-    };
-    baseTools[_getAllIcons.listGetAllIconsTool.name] = {
-      handler: _getAllIcons.getAllIconsTool,
-      inputSchema: null,
-      tool: _getAllIcons.listGetAllIconsTool
-    };
-  }
+  }), _getGuidelines.listGetGuidelinesTool.name, {
+    handler: _getGuidelines.getGuidelinesTool,
+    inputSchema: _getGuidelines.getGuidelinesInputSchema,
+    tool: _getGuidelines.listGetGuidelinesTool
+  }), _getAllTokens.listGetAllTokensTool.name, {
+    handler: _getAllTokens.getAllTokensTool,
+    inputSchema: null,
+    tool: _getAllTokens.listGetAllTokensTool
+  }), (0, _defineProperty2.default)((0, _defineProperty2.default)(_baseTools, _getAllIcons.listGetAllIconsTool.name, {
+    handler: _getAllIcons.getAllIconsTool,
+    inputSchema: null,
+    tool: _getAllIcons.listGetAllIconsTool
+  }), _getLintRules.listGetLintRulesTool.name, {
+    handler: _getLintRules.getLintRulesTool,
+    inputSchema: _getLintRules.getLintRulesInputSchema,
+    tool: _getLintRules.listGetLintRulesTool
+  }));
   return baseTools;
 };
 server.setRequestHandler(_types.ListToolsRequestSchema, /*#__PURE__*/function () {

package/dist/cjs/tools/get-all-icons/icons.js

@@ -0,0 +1,43 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.icons = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _metadata = _interopRequireDefault(require("@atlaskit/icon-lab/metadata"));
+var _metadata2 = require("@atlaskit/icon/metadata");
+// https://hello.atlassian.net/wiki/spaces/DST/pages/6558719954/Icon+content+type
+
+var icons = exports.icons = [].concat((0, _toConsumableArray2.default)(Object.entries(_metadata2.coreIconMetadata).map(function (_ref) {
+  var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
+    _key = _ref2[0],
+    icon = _ref2[1];
+  return {
+    componentName: icon.componentName,
+    package: icon.package,
+    categorization: icon.categorization,
+    keywords: icon.keywords,
+    status: icon.status,
+    usage: icon.usage,
+    shouldRecommendSmallIcon: icon.shouldRecommendSmallIcon,
+    team: icon.team
+  };
+})), (0, _toConsumableArray2.default)(Object.entries(_metadata.default).map(function (_ref3) {
+  var _ref4 = (0, _slicedToArray2.default)(_ref3, 2),
+    _key = _ref4[0],
+    icon = _ref4[1];
+  return {
+    componentName: icon.componentName,
+    package: icon.package,
+    categorization: icon.categorization,
+    //???
+    keywords: icon.keywords,
+    status: icon.status,
+    usage: icon.usage,
+    shouldRecommendSmallIcon: icon.shouldRecommendSmallIcon,
+    team: icon.team
+  };
+})));

package/dist/cjs/tools/get-all-icons/index.js

@@ -7,26 +7,11 @@ Object.defineProperty(exports, "__esModule", {
 exports.listGetAllIconsTool = exports.getAllIconsTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _zod = require("zod");
-var _metadata = require("@atlaskit/icon/metadata");
 var _helpers = require("../../helpers");
+var _icons = require("./icons");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-var icons = Object.entries(_metadata.coreIconMetadata).map(function (_ref) {
-  var _ref2 = (0, _slicedToArray2.default)(_ref, 2),
-    _key = _ref2[0],
-    icon = _ref2[1];
-  return {
-    componentName: icon.componentName,
-    package: icon.package,
-    categorization: icon.categorization,
-    keywords: icon.keywords,
-    status: icon.status,
-    usage: icon.usage,
-    shouldRecommendSmallIcon: icon.shouldRecommendSmallIcon
-  };
-});
 var listGetAllIconsTool = exports.listGetAllIconsTool = {
   name: 'ads_get_all_icons',
   description: "Fetch all Atlassian Design System icons. Only use when `ads_search_icons` does not return what you're looking for.",
@@ -40,12 +25,12 @@ var listGetAllIconsTool = exports.listGetAllIconsTool = {
   inputSchema: (0, _helpers.zodToJsonSchema)(_zod.z.object({}))
 };
 var getAllIconsTool = exports.getAllIconsTool = /*#__PURE__*/function () {
-  var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
+  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
           return _context.abrupt("return", {
-            content: icons.map(function (icon) {
+            content: _icons.icons.map(function (icon) {
               return {
                 // NOTE: Ideally one day the MCP would support structured content…
                 // eg. `type: 'object', data: icon`
@@ -61,6 +46,6 @@ var getAllIconsTool = exports.getAllIconsTool = /*#__PURE__*/function () {
     }, _callee);
   }));
   return function getAllIconsTool() {
-    return _ref3.apply(this, arguments);
+    return _ref.apply(this, arguments);
   };
 }();

package/dist/cjs/tools/get-all-tokens/index.js

@@ -8,8 +8,8 @@ exports.listGetAllTokensTool = exports.getAllTokensTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _zod = require("zod");
-var _tokenMetadata = require("@atlaskit/tokens/token-metadata");
 var _helpers = require("../../helpers");
+var _tokens = require("./tokens");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
 var inputSchema = _zod.z.object({});
@@ -31,15 +31,12 @@ var getAllTokensTool = exports.getAllTokensTool = /*#__PURE__*/function () {
       while (1) switch (_context.prev = _context.next) {
         case 0:
           return _context.abrupt("return", {
-            content: _tokenMetadata.tokens.map(function (token) {
+            content: _tokens.tokens.map(function (token) {
               return {
                 // NOTE: Ideally one day the MCP would support structured content…
                 // eg. `type: 'object', data: token`
                 type: 'text',
-                text: JSON.stringify({
-                  name: token.name,
-                  exampleValue: token.exampleValue
-                }, null, 2)
+                text: JSON.stringify(token, null, 2)
               };
             })
           });

package/dist/cjs/tools/get-all-tokens/tokens.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.tokens = void 0;
+var _tokenMetadata = require("@atlaskit/tokens/token-metadata");
+// https://hello.atlassian.net/wiki/spaces/DST/pages/6558592429/Token+content+type
+
+var tokens = exports.tokens = _tokenMetadata.tokens.map(function (metadata) {
+  var _metadata$exampleValu;
+  return {
+    name: metadata.name,
+    path: metadata.path,
+    description: metadata.description,
+    exampleValue: String((_metadata$exampleValu = metadata.exampleValue) !== null && _metadata$exampleValu !== void 0 ? _metadata$exampleValu : '')
+  };
+});