@atlaskit/ads-mcp 0.0.1

package/dist/esm/index.js

@@ -0,0 +1,92 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+/* eslint-disable import/extensions */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { instructions } from './instructions';
+import { getComponentDetailsTool, listGetComponentDetailsTool } from './tools/get-component-details';
+import { getComponentsTool, listGetComponentsTool } from './tools/get-components';
+import { getIconsTool, listGetIconsTool } from './tools/get-icons';
+import { getTokensTool, listGetTokensTool } from './tools/get-tokens';
+
+// eslint-disable-next-line import/no-extraneous-dependencies -- this uses require because not all node versions this package supports use the same import assertions/attributes
+var pkgJson = require('@atlaskit/ads-mcp/package.json');
+var server = new Server({
+  name: pkgJson.name || '@atlaskit/ads-mcp',
+  version: pkgJson.version || '0.0.0-unknown'
+}, {
+  instructions: instructions,
+  capabilities: {
+    // Tools are defined in the handlers below.
+    tools: {}
+  }
+});
+server.setRequestHandler(ListToolsRequestSchema, /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+  return _regeneratorRuntime.wrap(function _callee$(_context) {
+    while (1) switch (_context.prev = _context.next) {
+      case 0:
+        return _context.abrupt("return", {
+          tools: [listGetTokensTool, listGetComponentsTool, listGetComponentDetailsTool, listGetIconsTool]
+        });
+      case 1:
+      case "end":
+        return _context.stop();
+    }
+  }, _callee);
+})));
+var callTools = {
+  get_tokens: getTokensTool,
+  get_components: getComponentsTool,
+  get_component_details: getComponentDetailsTool,
+  get_icons: getIconsTool
+};
+
+// Handle tool execution
+server.setRequestHandler(CallToolRequestSchema, /*#__PURE__*/function () {
+  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(request) {
+    var tool;
+    return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          tool = callTools[request.params.name];
+          if (!tool) {
+            _context2.next = 3;
+            break;
+          }
+          return _context2.abrupt("return", tool(request.params.arguments));
+        case 3:
+          throw new Error("Tool '".concat(request.params.name, "' not found, only the following tools are available: ").concat(Object.keys(callTools).join(', ')));
+        case 4:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return function (_x) {
+    return _ref2.apply(this, arguments);
+  };
+}());
+function runServer() {
+  return _runServer.apply(this, arguments);
+}
+function _runServer() {
+  _runServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
+    var transport;
+    return _regeneratorRuntime.wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          transport = new StdioServerTransport();
+          _context3.next = 3;
+          return server.connect(transport);
+        case 3:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3);
+  }));
+  return _runServer.apply(this, arguments);
+}
+runServer().catch(function (error) {
+  throw new Error("Invalid input to ads-mcp: ".concat(JSON.stringify(error.errors)));
+});

package/dist/esm/instructions.js

@@ -0,0 +1 @@
+export var instructions = "\nYou are an expert in the Atlassian Design System (aka ADS). You are able to answer questions about the design system and provide guidance on what offerings to use when building user interfaces.\n\nYou are able to use the provided tools to help answer your questions, but may also access https://atlassian.design/llms.txt or https://atlassian.design/ directly for deeper research and information.\n";

package/dist/esm/schema.js

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
+export var releasePhase = z.enum(['early_access', 'beta', 'general_availability', 'intent_to_deprecate', 'deprecated']).default('general_availability').describe("\nThe release phase or status of the offering, providing guidance on what you can expect at each phase and who can use them.\nYou should typically only use `general_availability` or `beta` components. If a release phase or status is not defined, you should assume it is `general_availability`.\n\n- `early_access`: New experimental feature. There may be breaking changes in minor releases at versions `0.x`. We don't recommend using this unless you are part of an early access pilot group, as support is otherwise not available.\n- `beta`: New and ready to use. The feature is supported and stable at versions `1.0`+. We are working on improvements based on customer feedback. This may include expanding feature sets, and evolving tooling, guidance, and self-service. Breaking changes will only be made in major releases, and should be infrequent.\n- `general_availability`: Fully stable and ready to use.\n- `intent_to_deprecate` aka Caution: This feature is being considered for deprecation. There may be some issues with this feature that need to be resolved. If you are not already using the feature, use the recommended alternative instead.\n- `deprecated`: This feature is no longer supported and will be removed after the deprecation period ends. We have provided a recommended solution to replace it and communicated how to move to it.\n");
+export var emptyInputSchema = zodToJsonSchema(z.object({}));

package/dist/esm/tools/get-component-details/index.js

@@ -0,0 +1,81 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { components } from '../get-components/components';
+var inputSchema = z.object({
+  names: z.array(z.string()).describe('The name of the component(s) to get full details about')
+});
+export var listGetComponentDetailsTool = {
+  name: 'get_component_details',
+  description: "You MUST use this to fetch detailed information about a specific Atlassian Design System component(s) including code examples, props, accessibility guidelines, and other usage guidance.\nIf you're not sure how to query this, you should use the `get_components` tool to get a list of all components and their names before using this tool.\n",
+  annotations: {
+    title: 'Get ADS component details',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(inputSchema)
+};
+var cleanName = function cleanName(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, '');
+};
+export var getComponentDetailsTool = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
+    var names, filteredComponents;
+    return _regeneratorRuntime.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          names = params.names.filter(Boolean).map(cleanName);
+          if (names.length) {
+            _context.next = 3;
+            break;
+          }
+          return _context.abrupt("return", {
+            isError: true,
+            content: [{
+              type: 'text',
+              text: "Error: Required parameter 'names' is missing. Available components: ".concat(components.map(function (c) {
+                return c.name;
+              }).join(', '))
+            }]
+          });
+        case 3:
+          filteredComponents = components.filter(function (c) {
+            return names.includes(cleanName(c.name));
+          });
+          if (filteredComponents.length) {
+            _context.next = 6;
+            break;
+          }
+          return _context.abrupt("return", {
+            isError: true,
+            content: [{
+              type: 'text',
+              text: "Error: Component not found for '".concat(names.join(', '), "'. Available components: ").concat(components.map(function (c) {
+                return c.name;
+              }).join(', '))
+            }]
+          });
+        case 6:
+          return _context.abrupt("return", {
+            content: filteredComponents.map(function (component) {
+              return {
+                // NOTE: Ideally one day the MCP would support structured content…
+                // eg. `type: 'object', data: component`
+                type: 'text',
+                text: JSON.stringify(component, null, 2)
+              };
+            })
+          });
+        case 7:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getComponentDetailsTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();