@primer/mcp 0.5.0 → 0.5.1-rc.9cb467491

package/dist/index.js

@@ -1,2 +1,2 @@
-import { t as server } from "./server-rl4CHqO6.js";
+import { t as server } from "./server-Dv5XFnmA.js";
 export { server };

package/dist/{server-rl4CHqO6.js → server-Dv5XFnmA.js}

@@ -692,7 +692,7 @@ function runStylelint(css) {
 //#region src/server.ts
 const server = new McpServer({
 	name: "Primer",
-	version: "0.5.0"
+	version: "0.5.1"
 });
 const turndownService = new TurndownService();
 const allTokensWithGuidelines = loadAllTokensWithGuidelines();
@@ -736,11 +736,11 @@ ${listComponents().map((component) => {
 			return `- ${component.name}`;
 		}).join("\n")}
 
-You can use the \`get_component\` tool to get more information about a specific component. You can use these components from the @primer/react package.`
+Use \`get_component\` for exactly one component and \`get_component_batch\` for 2 to 10 components. You can use these components from the @primer/react package.`
 	}] };
 });
 server.registerTool("get_component", {
-	description: "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.",
+	description: "Retrieve official documentation and usage details for exactly one React component from the @primer/react package. Use get_component_batch for 2 to 10 components.",
 	inputSchema: { name: z.string().describe("The name of the component to retrieve") },
 	annotations: { readOnlyHint: true }
 }, async ({ name }) => {
@@ -767,7 +767,7 @@ server.registerTool("get_component", {
 	};
 });
 server.registerTool("get_component_batch", {
-	description: "Retrieve documentation for multiple Primer React components in one call. Pass all component names you need at once. Docs are fetched in parallel to avoid repeated MCP round-trips when resolving several components. For a single component, prefer get_component instead.",
+	description: "Retrieve official documentation and usage details for 2 to 10 React components from the @primer/react package in one call. Use get_component for exactly one component.",
 	inputSchema: { names: z.array(z.string()).min(2).max(10).describe("Component names to retrieve (e.g. [\"ActionMenu\", \"Button\", \"Pagination\"])") },
 	annotations: { readOnlyHint: true }
 }, async ({ names }) => {
@@ -1211,7 +1211,7 @@ server.registerTool("review_alt_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: .4 },
+		temperature: .4,
 		maxTokens: 500
 	});
 	return {

package/dist/stdio.js

@@ -1,4 +1,4 @@
-import { t as server } from "./server-rl4CHqO6.js";
+import { t as server } from "./server-Dv5XFnmA.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 //#region src/transports/stdio.ts
 const transport = new StdioServerTransport();

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.5.0",
+  "version": "0.5.1-rc.9cb467491",
   "type": "module",
   "bin": {
     "mcp": "./bin/mcp.js"
@@ -34,7 +34,7 @@
     "watch": "rolldown -c -w"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@primer/octicons": "^19.15.5",
     "@primer/primitives": "10.x || 11.x",
     "@primer/react": "^38.33.0",

package/src/server.test.ts

@@ -33,6 +33,28 @@ describe('get_component_batch', () => {
     })
   }
 
+  it('documents which component tool to use for each supported count', async () => {
+    const {tools} = await client.listTools()
+    const getComponent = tools.find(tool => tool.name === 'get_component')
+    const getComponentBatch = tools.find(tool => tool.name === 'get_component_batch')
+    const listResult = await client.callTool({name: 'list_components'})
+
+    expect(getComponent?.description).toBe(
+      'Retrieve official documentation and usage details for exactly one React component from the @primer/react package. Use get_component_batch for 2 to 10 components.',
+    )
+    expect(getComponentBatch?.description).toBe(
+      'Retrieve official documentation and usage details for 2 to 10 React components from the @primer/react package in one call. Use get_component for exactly one component.',
+    )
+    expect(listResult.content).toContainEqual(
+      expect.objectContaining({
+        type: 'text',
+        text: expect.stringContaining(
+          'Use `get_component` for exactly one component and `get_component_batch` for 2 to 10 components.',
+        ),
+      }),
+    )
+  })
+
   it('requires between 2 and 10 names', async () => {
     const tooFew = await callBatch(['Button'])
     const tooMany = await callBatch(Array.from({length: 11}, (_, index) => `Component${index}`))

package/src/server.ts

@@ -106,7 +106,7 @@ server.registerTool(
 
 ${components.join('\n')}
 
-You can use the \`get_component\` tool to get more information about a specific component. You can use these components from the @primer/react package.`,
+Use \`get_component\` for exactly one component and \`get_component_batch\` for 2 to 10 components. You can use these components from the @primer/react package.`,
         },
       ],
     }
@@ -117,7 +117,7 @@ server.registerTool(
   'get_component',
   {
     description:
-      '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.',
+      'Retrieve official documentation and usage details for exactly one React component from the @primer/react package. Use get_component_batch for 2 to 10 components.',
     inputSchema: {
       name: z.string().describe('The name of the component to retrieve'),
     },
@@ -165,9 +165,7 @@ server.registerTool(
   'get_component_batch',
   {
     description:
-      'Retrieve documentation for multiple Primer React components in one call. ' +
-      'Pass all component names you need at once. Docs are fetched in parallel to avoid repeated MCP round-trips when resolving several components. ' +
-      'For a single component, prefer get_component instead.',
+      'Retrieve official documentation and usage details for 2 to 10 React components from the @primer/react package in one call. Use get_component for exactly one component.',
     inputSchema: {
       names: z
         .array(z.string())
@@ -1037,7 +1035,7 @@ server.registerTool(
           },
         },
       ],
-      sampling: {temperature: 0.4},
+      temperature: 0.4,
       maxTokens: 500,
     })