@primer/mcp 0.0.4 → 0.0.5

package/dist/index.js

@@ -1,4 +1,4 @@
-export { s as server } from './server-DHzOLtG9.js';
+export { s as server } from './server-Ccnupv1s.js';
 import '@modelcontextprotocol/sdk/server/mcp.js';
 import 'cheerio';
 import 'zod';

package/dist/{server-DSob2l4p.js → server-BzATDQ5A.js}

@@ -163,7 +163,7 @@ function serialize(value) {
   }).join('\n');
 }
 
-var version = "0.0.4-rc.0";
+var version = "0.1.0-rc.1";
 var packageJson = {
 	version: version};
 
@@ -234,7 +234,7 @@ You can use the \`get_component\` tool to get more information about a specific
     }]
   };
 });
-server.tool('get_component', 'Get a specific component by name', {
+server.tool('get_component', 'Retrieve documentation and usage details for a specific React component from the @primer/react package by its name. This tool provides the official Primer documentation for any listed component, making it easy to inspect, reuse, or integrate components in your project.', {
   name: z.string().describe('The name of the component to retrieve')
 }, async ({
   name
@@ -247,7 +247,7 @@ server.tool('get_component', 'Get a specific component by name', {
     return {
       content: [{
         type: 'text',
-        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
+        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
       }]
     };
   }
@@ -376,7 +376,7 @@ ${text}`
     }]
   };
 });
-server.tool('get_component_accessibility_guidelines', 'Get accessibility information for how to use a component from Primer React', {
+server.tool('get_component_accessibility_guidelines', 'Retrieve accessibility guidelines and best practices for a specific component from the @primer/react package by its name. Use this tool to get official accessibility recommendations, usage tips, and requirements to ensure your UI components are inclusive and meet accessibility standards.', {
   name: z.string().describe('The name of the component to retrieve')
 }, async ({
   name
@@ -389,7 +389,7 @@ server.tool('get_component_accessibility_guidelines', 'Get accessibility informa
     return {
       content: [{
         type: 'text',
-        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
+        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
       }]
     };
   }
@@ -668,4 +668,51 @@ The following list of coding guidelines must be followed:
   };
 });
 
+// -----------------------------------------------------------------------------
+// Accessibility
+// -----------------------------------------------------------------------------
+
+/**
+ * The `review_alt_text` tool is experimental and may be removed in future versions.
+ *
+ * The intent of this tool is to assist products like Copilot Code Review and Copilot Coding Agent
+ * in reviewing both user- and AI-generated alt text for images, ensuring compliance with accessibility guidelines.
+ * This tool is not intended to replace human-generated alt text; rather, it supports the review process
+ * by providing suggestions for improvement. It should be used alongside human review, not as a substitute.
+ *
+ *
+ **/
+server.tool('review_alt_text', 'Evaluates image alt text against accessibility best practices and context relevance.', {
+  surroundingText: z.string().describe('Text surrounding the image, relevant to the image.'),
+  alt: z.string().describe('The alt text of the image being evaluated'),
+  image: z.union([z.instanceof(File).describe('The image src file being evaluated'), z.string().url().describe('The URL of the image src being evaluated'), z.string().describe('The file path of the image src being evaluated')]).describe('The image file, file path, or URL being evaluated')
+}, async ({
+  surroundingText,
+  alt,
+  image
+}) => {
+  // Call the LLM through MCP sampling
+  const response = await server.server.createMessage({
+    messages: [{
+      role: 'user',
+      content: {
+        type: 'text',
+        text: `Does this alt text: '${alt}' meet accessibility guidelines and describe the image: ${image} accurately in context of this surrounding text: '${surroundingText}'?\n\n`
+      }
+    }],
+    sampling: {
+      temperature: 0.4
+    },
+    maxTokens: 500
+  });
+  return {
+    content: [{
+      type: 'text',
+      text: response.content.type === 'text' ? response.content.text : 'Unable to generate summary'
+    }],
+    altTextEvaluation: response.content.type === 'text' ? response.content.text : 'Unable to generate summary',
+    nextSteps: `If the evaluation indicates issues with the alt text, provide more meaningful alt text based on the feedback. DO NOT run this tool repeatedly on the same image - evaluations may vary slightly with each run.`
+  };
+});
+
 export { server as s };

package/dist/{server-DHzOLtG9.js → server-Ccnupv1s.js}

@@ -163,7 +163,7 @@ function serialize(value) {
   }).join('\n');
 }
 
-var version = "0.0.4-rc.0";
+var version = "0.0.5";
 var packageJson = {
 	version: version};
 
@@ -234,7 +234,7 @@ You can use the \`get_component\` tool to get more information about a specific
     }]
   };
 });
-server.tool('get_component', 'Get a specific component by name', {
+server.tool('get_component', 'Retrieve documentation and usage details for a specific React component from the @primer/react package by its name. This tool provides the official Primer documentation for any listed component, making it easy to inspect, reuse, or integrate components in your project.', {
   name: z.string().describe('The name of the component to retrieve')
 }, async ({
   name
@@ -247,7 +247,7 @@ server.tool('get_component', 'Get a specific component by name', {
     return {
       content: [{
         type: 'text',
-        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
+        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
       }]
     };
   }
@@ -376,7 +376,7 @@ ${text}`
     }]
   };
 });
-server.tool('get_component_accessibility_guidelines', 'Get accessibility information for how to use a component from Primer React', {
+server.tool('get_component_accessibility_guidelines', 'Retrieve accessibility guidelines and best practices for a specific component from the @primer/react package by its name. Use this tool to get official accessibility recommendations, usage tips, and requirements to ensure your UI components are inclusive and meet accessibility standards.', {
   name: z.string().describe('The name of the component to retrieve')
 }, async ({
   name
@@ -389,7 +389,7 @@ server.tool('get_component_accessibility_guidelines', 'Get accessibility informa
     return {
       content: [{
         type: 'text',
-        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`
+        text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`
       }]
     };
   }

package/dist/stdio.js

@@ -1,5 +1,5 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { s as server } from './server-DHzOLtG9.js';
+import { s as server } from './server-Ccnupv1s.js';
 import '@modelcontextprotocol/sdk/server/mcp.js';
 import 'cheerio';
 import 'zod';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@primer/mcp",
   "description": "An MCP server that connects AI tools to the Primer Design System",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "type": "module",
   "bin": {
     "mcp": "./bin/mcp.js"
@@ -33,7 +33,7 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@primer/octicons": "^19.15.5",
     "@primer/primitives": "10.x || 11.x",
-    "@primer/react": "^38.0.0-rc.0",
+    "@primer/react": "^38.0.0-rc.3",
     "cheerio": "^1.0.0",
     "turndown": "^7.2.0",
     "zod": "^3.23.8"

package/src/server.ts

@@ -86,7 +86,7 @@ You can use the \`get_component\` tool to get more information about a specific
 
 server.tool(
   'get_component',
-  'Get a specific component by name',
+  'Retrieve documentation and usage details for a specific React component from the @primer/react package by its name. This tool provides the official Primer documentation for any listed component, making it easy to inspect, reuse, or integrate components in your project.',
   {
     name: z.string().describe('The name of the component to retrieve'),
   },
@@ -100,7 +100,7 @@ server.tool(
         content: [
           {
             type: 'text',
-            text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`,
+            text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`,
           },
         ],
       }
@@ -270,7 +270,7 @@ ${text}`,
 
 server.tool(
   'get_component_accessibility_guidelines',
-  'Get accessibility information for how to use a component from Primer React',
+  'Retrieve accessibility guidelines and best practices for a specific component from the @primer/react package by its name. Use this tool to get official accessibility recommendations, usage tips, and requirements to ensure your UI components are inclusive and meet accessibility standards.',
   {
     name: z.string().describe('The name of the component to retrieve'),
   },
@@ -284,7 +284,7 @@ server.tool(
         content: [
           {
             type: 'text',
-            text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`get_components\` tool.`,
+            text: `There is no component named \`${name}\` in the @primer/react package. For a full list of components, use the \`list_components\` tool.`,
           },
         ],
       }