@react-aria/mcp 1.1.0 → 1.2.0

package/README.md

@@ -109,6 +109,10 @@ Follow Windsurf MCP [documentation](https://docs.windsurf.com/windsurf/cascade/m
 | `get_react_aria_page_info` | `{ page_name: string }` | Return page description and list of section titles. |
 | `get_react_aria_page` | `{ page_name: string, section_name?: string }` | Return full page markdown, or only the specified section. |
 
+## Privacy Policy
+
+See [Adobe's privacy policy](https://www.adobe.com/privacy/policy.html).
+
 ## Development
 
 ### Testing locally
@@ -135,4 +139,19 @@ Update your MCP client configuration to use the local MCP server:
     }
   }
 }
+```
+
+## Bundling
+
+To build an [MCP Bundle (MCPB)](https://github.com/modelcontextprotocol/mcpb), first prepare the staging directory:
+
+```bash
+yarn workspace @react-spectrum/s2-docs generate:mcpb
+```
+
+Then validate and pack using the [`@anthropic-ai/mcpb`](https://www.npmjs.com/package/@anthropic-ai/mcpb) CLI (paths are printed by the script above):
+
+```bash
+npx @anthropic-ai/mcpb validate <staging-dir>
+npx @anthropic-ai/mcpb pack <staging-dir> <output-path>
 ```

package/dist/react-aria/src/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /// <reference types="node" />
-import { errorToString } from '../../shared/src/utils.js';
+import { errorToString, readPackageVersion } from '../../shared/src/utils.js';
 import { startServer } from '../../shared/src/server.js';
 // CLI entry for React Aria
 (async () => {
@@ -10,7 +10,7 @@ import { startServer } from '../../shared/src/server.js';
             console.log('Usage: npx @react-aria/mcp@latest\n\nStarts the MCP server for React Aria documentation.');
             process.exit(0);
         }
-        await startServer('react-aria', '0.1.0');
+        await startServer('react-aria', readPackageVersion(import.meta.url));
     }
     catch (err) {
         console.error(errorToString(err));

package/dist/shared/src/page-manager.js

@@ -67,7 +67,13 @@ export async function resolvePageRef(library, pageName) {
             return maybe;
         }
         const filePath = `${baseUrl}/${normalized}.md`;
-        const stub = { key: normalized, name: path.basename(normalized), description: undefined, filePath, sections: [] };
+        const stub = {
+            key: normalized,
+            name: path.basename(normalized),
+            description: undefined,
+            filePath,
+            sections: []
+        };
         pageCache.set(stub.key, stub);
         return stub;
     }

package/dist/shared/src/server.js

@@ -4,11 +4,22 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { parseSectionsFromMarkdown } from './parser.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-export async function startServer(library, version, registerAdditionalTools) {
+export async function startServer(library, version, options = {}) {
     const server = new McpServer({
         name: library === 's2' ? 's2-docs-server' : 'react-aria-docs-server',
         version
     });
+    const libraries = [library, ...(options.additionalLibraries ?? [])];
+    for (const lib of libraries) {
+        await registerLibraryDocsTools(server, lib);
+    }
+    if (options.registerAdditionalTools) {
+        await options.registerAdditionalTools(server);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+async function registerLibraryDocsTools(server, library) {
     // Build page index at startup.
     try {
         await buildPageIndex(library);
@@ -18,9 +29,12 @@ export async function startServer(library, version, registerAdditionalTools) {
     }
     const toolPrefix = library === 's2' ? 's2' : 'react_aria';
     server.registerTool(`list_${toolPrefix}_pages`, {
-        title: library === 's2' ? 'List React Spectrum (@react-spectrum/s2) docs pages' : 'List React Aria docs pages',
+        title: library === 's2'
+            ? 'List React Spectrum (@react-spectrum/s2) docs pages'
+            : 'List React Aria docs pages',
         description: `Returns a list of available pages in the ${library} docs.`,
-        inputSchema: { includeDescription: z.boolean().optional() }
+        inputSchema: { includeDescription: z.boolean().optional() },
+        annotations: { readOnlyHint: true, openWorldHint: true }
     }, async ({ includeDescription }) => {
         const pages = await buildPageIndex(library);
         const items = pages
@@ -33,7 +47,8 @@ export async function startServer(library, version, registerAdditionalTools) {
     server.registerTool(`get_${toolPrefix}_page_info`, {
         title: 'Get page info',
         description: 'Returns page description and list of sections for a given page.',
-        inputSchema: { page_name: z.string() }
+        inputSchema: { page_name: z.string() },
+        annotations: { readOnlyHint: true, openWorldHint: true }
     }, async ({ page_name }) => {
         const ref = await resolvePageRef(library, page_name);
         const info = await ensureParsedPage(ref);
@@ -47,7 +62,8 @@ export async function startServer(library, version, registerAdditionalTools) {
     server.registerTool(`get_${toolPrefix}_page`, {
         title: 'Get page markdown',
         description: 'Returns the full markdown content for a page, or a specific section if provided.',
-        inputSchema: { page_name: z.string(), section_name: z.string().optional() }
+        inputSchema: { page_name: z.string(), section_name: z.string().optional() },
+        annotations: { readOnlyHint: true, openWorldHint: true }
     }, async ({ page_name, section_name }) => {
         const ref = await resolvePageRef(library, page_name);
         let text;
@@ -68,9 +84,4 @@ export async function startServer(library, version, registerAdditionalTools) {
         const snippet = lines.slice(section.startLine, section.endLine).join('\n');
         return { content: [{ type: 'text', text: snippet }] };
     });
-    if (registerAdditionalTools) {
-        await registerAdditionalTools(server);
-    }
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
 }

package/dist/shared/src/utils.js

@@ -1,8 +1,31 @@
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { readFileSync } from 'fs';
+// Resolves the version from the nearest package.json above the CLI entry point.
+// Both the npm-published layout (dist/<lib>/src/index.js) and the .mcpb bundle
+// layout (server/<lib>/src/index.js) place package.json three levels up.
+export function readPackageVersion(entryUrl) {
+    const entryDir = dirname(fileURLToPath(entryUrl));
+    const pkgPath = join(entryDir, '..', '..', '..', 'package.json');
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        if (typeof pkg.version === 'string' && pkg.version.length > 0) {
+            return pkg.version;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return '0.0.0';
+}
 export function errorToString(err) {
     if (err && typeof err === 'object' && 'stack' in err && typeof err.stack === 'string') {
         return err.stack;
     }
-    if (err && typeof err === 'object' && 'message' in err && typeof err.message === 'string') {
+    if (err &&
+        typeof err === 'object' &&
+        'message' in err &&
+        typeof err.message === 'string') {
         return err.message;
     }
     try {

package/package.json

@@ -1,9 +1,26 @@
 {
   "name": "@react-aria/mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for React Aria documentation",
-  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adobe/react-spectrum"
+  },
   "bin": "dist/react-aria/src/index.js",
+  "source": "src/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/main.js",
+  "module": "dist/module.js",
+  "types": "dist/types.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "prepublishOnly": "yarn build",
     "build": "tsc -p tsconfig.json",
@@ -21,22 +38,5 @@
   "engines": {
     "node": ">=18"
   },
-  "license": "Apache-2.0",
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/adobe/react-spectrum"
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "sideEffects": false,
-  "main": "dist/main.js",
-  "module": "dist/module.js",
-  "types": "dist/types.d.ts",
-  "source": "src/index.ts",
-  "gitHead": "a6999bdf494a2e9c0381a5881908328bdd22ddae"
+  "gitHead": "3577a20859b9585a000010c720f6ee39c1c588cc"
 }

package/src/index.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /// <reference types="node" />
-import {errorToString} from '../../shared/src/utils.js';
+import {errorToString, readPackageVersion} from '../../shared/src/utils.js';
 import {startServer} from '../../shared/src/server.js';
 
 // CLI entry for React Aria
@@ -8,10 +8,12 @@ import {startServer} from '../../shared/src/server.js';
   try {
     const arg = (process.argv[2] || '').trim();
     if (arg === '--help' || arg === '-h' || arg === 'help') {
-      console.log('Usage: npx @react-aria/mcp@latest\n\nStarts the MCP server for React Aria documentation.');
+      console.log(
+        'Usage: npx @react-aria/mcp@latest\n\nStarts the MCP server for React Aria documentation.'
+      );
       process.exit(0);
     }
-    await startServer('react-aria', '0.1.0');
+    await startServer('react-aria', readPackageVersion(import.meta.url));
   } catch (err) {
     console.error(errorToString(err));
     process.exit(1);