Function registerLibraryDocsTools

packages/dev/mcp/shared/src/server.ts:35–123

(server: McpServer, library: Library)

}

async function registerLibraryDocsTools(server: McpServer, library: Library) {
  // Build page index at startup.
  try {
    await buildPageIndex(library);
  } catch (e) {
    console.warn(`Warning: failed to load ${library} docs index (${errorToString(e)}).`);
  }

  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',
      description: `Returns a list of available pages in the ${library} docs.`,
      inputSchema: {includeDescription: z.boolean().optional()},
      annotations: {readOnlyHint: true, openWorldHint: true}
    },
    async ({includeDescription}) => {
      const pages = await buildPageIndex(library);
      const items = pages
        .sort((a, b) => a.key.localeCompare(b.key))
        .map(p =>
          includeDescription ? {name: p.name, description: p.description ?? ''} : {name: p.name}
        );
      return {
        content: [{type: 'text', text: JSON.stringify(items, null, 2)}]
      };
    }
  );

  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()},
      annotations: {readOnlyHint: true, openWorldHint: true}
    },
    async ({page_name}) => {
      const ref = await resolvePageRef(library, page_name);
      const info = await ensureParsedPage(ref);
      const out = {
        name: info.name,
        description: info.description ?? '',
        sections: info.sections.map(s => s.name)
      };
      return {content: [{type: 'text', text: JSON.stringify(out, null, 2)}]};
    }
  );

  server.registerTool(
    `get_${toolPrefix}_page`,
    {
      title: 'Get page markdown',