@atlaskit/ads-mcp 0.17.0 → 0.17.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @atlaskit/ads-mcp
 
+## 0.17.2
+
+### Patch Changes
+
+- Updated dependencies
+
+## 0.17.1
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 0.17.0
 
 ### Minor 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

@@ -21,9 +21,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 +63,7 @@ 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 = (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)({}, _analyzeA11y.listAnalyzeA11yTool.name, {
     handler: _analyzeA11y.analyzeA11yTool,
     inputSchema: _analyzeA11y.analyzeA11yInputSchema,
     tool: _analyzeA11y.listAnalyzeA11yTool
@@ -97,30 +95,19 @@ var getToolRegistry = exports.getToolRegistry = function getToolRegistry() {
     handler: _i18nConversion.i18nConversionTool,
     inputSchema: _i18nConversion.i18nConversionInputSchema,
     tool: _i18nConversion.listI18nConversionTool
+  }), _getGuidelines.listGetGuidelinesTool.name, {
+    handler: _getGuidelines.getGuidelinesTool,
+    inputSchema: _getGuidelines.getGuidelinesInputSchema,
+    tool: _getGuidelines.listGetGuidelinesTool
   });
 
   // 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,

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 : '')
+  };
+});