@atlaskit/ads-mcp 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @atlaskit/ads-mcp
 
+## 0.2.5
+
+### Patch Changes
+
+- [`098cfbb01dc36`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/098cfbb01dc36) -
+  Add missing npmignore files to remove unnecessary files from published package
+
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 0.2.3
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "0.2.3",
+	"version": "0.2.5",
 	"description": "The official Atlassian Design System MCP server to develop apps and user interfaces matching the Atlassian style.",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -29,7 +29,7 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@atlaskit/icon": "^27.9.0",
+		"@atlaskit/icon": "^28.0.0",
 		"@atlaskit/tokens": "^6.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@modelcontextprotocol/sdk": "^1.8.0",
@@ -37,7 +37,6 @@
 		"zod-to-json-schema": "^3.24.5"
 	},
 	"devDependencies": {
-		"ts-node": "^10.9.1",
-		"typescript": "~5.4.2"
+		"ts-node": "^10.9.1"
 	}
 }

package/build/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "extends": "../tsconfig",
-  "compilerOptions": {
-    "target": "es5",
-    "paths": {}
-  },
-  "include": [
-    "../src/**/*.ts",
-    "../src/**/*.tsx"
-  ],
-  "exclude": [
-    "../src/**/__tests__/*",
-    "../src/**/*.test.*",
-    "../src/**/test.*",
-    "../src/**/examples.*",
-    "../src/**/examples/*",
-    "../src/**/examples/**/*",
-    "../src/**/*.stories.*",
-    "../src/**/stories/*",
-    "../src/**/stories/**/*"
-  ]
-}

package/src/index.tsx

@@ -1,70 +0,0 @@
-/* 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
-const pkgJson = require('@atlaskit/ads-mcp/package.json');
-
-const server = new Server(
-	{
-		name: pkgJson.name || '@atlaskit/ads-mcp',
-		version: pkgJson.version || '0.0.0-unknown',
-	},
-	{
-		instructions,
-		capabilities: {
-			// Tools are defined in the handlers below.
-			tools: {},
-		},
-	},
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-	return {
-		tools: [
-			listGetTokensTool,
-			listGetComponentsTool,
-			listGetComponentDetailsTool,
-			listGetIconsTool,
-		],
-	};
-});
-
-const callTools: Record<string, (params: any) => Promise<any>> = {
-	get_tokens: getTokensTool,
-	get_components: getComponentsTool,
-	get_component_details: getComponentDetailsTool,
-	get_icons: getIconsTool,
-};
-
-// Handle tool execution
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-	const tool = callTools[request.params.name];
-
-	if (tool) {
-		return tool(request.params.arguments);
-	}
-
-	throw new Error(
-		`Tool '${request.params.name}' not found, only the following tools are available: ${Object.keys(callTools).join(', ')}`,
-	);
-});
-
-async function runServer() {
-	const transport = new StdioServerTransport();
-	await server.connect(transport);
-}
-
-runServer().catch((error) => {
-	throw new Error(`Invalid input to ads-mcp: ${JSON.stringify(error.errors)}`);
-});

package/src/instructions.tsx

@@ -1,5 +0,0 @@
-export const instructions = `
-You 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.
-
-You 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.
-`;

package/src/schema.tsx

@@ -1,19 +0,0 @@
-import { z } from 'zod';
-import zodToJsonSchema from 'zod-to-json-schema';
-
-export const releasePhase = z
-	.enum(['early_access', 'beta', 'general_availability', 'intent_to_deprecate', 'deprecated'])
-	.default('general_availability').describe(`
-The release phase or status of the offering, providing guidance on what you can expect at each phase and who can use them.
-You 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\`.
-
-- \`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.
-- \`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.
-- \`general_availability\`: Fully stable and ready to use.
-- \`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.
-- \`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.
-`);
-
-export type ReleasePhase = z.infer<typeof releasePhase>;
-
-export const emptyInputSchema = zodToJsonSchema(z.object({}));

package/src/tools/get-component-details/index.tsx

@@ -1,64 +0,0 @@
-import { z } from 'zod';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-
-import { components } from '../get-components/components';
-
-const inputSchema = z.object({
-	names: z.array(z.string()).describe('The name of the component(s) to get full details about'),
-});
-
-export const 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.
-If 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.
-`,
-	annotations: {
-		title: 'Get ADS component details',
-		readOnlyHint: true,
-		destructiveHint: false,
-		idempotentHint: true,
-		openWorldHint: true,
-	},
-	inputSchema: zodToJsonSchema(inputSchema),
-};
-
-const cleanName = (name: string) => name.trim().toLowerCase().replace(/\s+/g, '');
-
-export const getComponentDetailsTool = async (params: z.infer<typeof inputSchema>) => {
-	const names = params.names.filter(Boolean).map(cleanName);
-
-	if (!names.length) {
-		return {
-			isError: true,
-			content: [
-				{
-					type: 'text',
-					text: `Error: Required parameter 'names' is missing. Available components: ${components.map((c) => c.name).join(', ')}`,
-				},
-			],
-		};
-	}
-
-	const filteredComponents = components.filter((c) => names.includes(cleanName(c.name)));
-
-	if (!filteredComponents.length) {
-		return {
-			isError: true,
-			content: [
-				{
-					type: 'text',
-					text: `Error: Component not found for '${names.join(', ')}'. Available components: ${components.map((c) => c.name).join(', ')}`,
-				},
-			],
-		};
-	}
-
-	return {
-		content: filteredComponents.map((component) => ({
-			// NOTE: Ideally one day the MCP would support structured content…
-			// eg. `type: 'object', data: component`
-			type: 'text',
-			text: JSON.stringify(component, null, 2),
-		})),
-	};
-};