@czi-sds/mcp 0.2.2 → 0.3.0

package/dist/stdio.js

@@ -632,11 +632,199 @@ var getTailwindTokensTool = {
     );
   }
 };
+var filename2 = fileURLToPath(import.meta.url);
+var dirname2 = path.dirname(filename2);
+function mapComponentToFile(componentName, exportedFiles) {
+  const componentToFileMap = {
+    // Button components
+    "Button": "Buttons",
+    "ButtonDropdown": "Buttons",
+    "ButtonIcon": "Buttons",
+    "ButtonToggle": "Buttons",
+    // Table components
+    "TableHeader": "Table",
+    "TableRow": "Table",
+    // Input components
+    "InputCheckbox": "Control-Inputs",
+    "InputRadio": "Control-Inputs",
+    "InputToggle": "Control-Inputs",
+    "InputText": "Field-Inputs",
+    "InputDropdown": "Dropdown-Input",
+    "InputSearch": "Search-Input",
+    "InputSlider": "Control-Inputs",
+    // Dropdown components
+    "Dropdown": "Dropdown-Menu",
+    "DropdownMenu": "Dropdown-Menu",
+    // Content components
+    "ContentCard": "Content-Card",
+    "LoadingIndicator": "Loading-Indicator",
+    // Navigation components
+    "NavigationFooter": "Navigation",
+    "NavigationHeader": "Navigation",
+    "NavigationJumpTo": "Navigation",
+    // Control components
+    "SegmentedControl": "Segmented-Control",
+    // List and menu components
+    "List": "Lists",
+    "Menu": "Dropdown-Menu",
+    "MenuItem": "Dropdown-Menu",
+    "MenuSelect": "Dropdown-Menu",
+    // Tag components
+    "Tag": "Tags",
+    "TagFilter": "Tags",
+    // Tooltip components
+    "Tooltip": "Tooltips",
+    "TooltipCondensed": "Tooltips",
+    "TooltipTable": "Tooltips",
+    // Table Cell components
+    "CellBasic": "Table",
+    "CellComponent": "Table",
+    "CellHeader": "Table",
+    // Filter components
+    "ComplexFilter": "Filters",
+    // Other components
+    "Icon": "Icons",
+    "Chip": "Tags",
+    // Chips are often similar to tags
+    "Pagination": "Navigation"
+    // Pagination is often part of navigation
+  };
+  const mappedFile = componentToFileMap[componentName];
+  if (mappedFile && exportedFiles.includes(mappedFile)) {
+    return `${mappedFile}.md`;
+  }
+  if (exportedFiles.includes(componentName)) {
+    return `${componentName}.md`;
+  }
+  return null;
+}
+function getExportedFiles() {
+  try {
+    const possiblePaths = [
+      path.join(dirname2, "../../data/zeroheight-exports"),
+      // From src/lib in dev
+      path.join(dirname2, "../data/zeroheight-exports"),
+      // From dist in prod
+      path.join(process.cwd(), "data/zeroheight-exports")
+      // From current working directory
+    ];
+    let exportDir = "";
+    for (const p of possiblePaths) {
+      if (fs.existsSync(p)) {
+        exportDir = p;
+        break;
+      }
+    }
+    if (!exportDir) {
+      console.warn("Export directory not found in any expected location. Please run Zeroheight export first.");
+      return [];
+    }
+    const files = fs.readdirSync(exportDir).filter((file) => file.endsWith(".md") && file !== "README.md").map((file) => file.replace(".md", ""));
+    return files;
+  } catch (error) {
+    console.warn("Could not read exported files:", error);
+    return [];
+  }
+}
+function getComponentsWithDocs(allComponents, exportedFiles) {
+  return allComponents.filter((component) => {
+    const mappedFile = mapComponentToFile(component, exportedFiles);
+    return mappedFile !== null;
+  });
+}
+var getComponentDocsTool = {
+  name: "get_component_docs",
+  description: "Get design system documentation for a specific component. Retrieves the corresponding Zeroheight documentation file for the given component name. Supports all SDS components and maps them to their appropriate documentation files.",
+  async ctx() {
+    try {
+      const componentList = await getAllComponentNames();
+      const allComponents = [
+        ...componentList.components,
+        ...componentList["data-viz"]
+      ];
+      const exportedFiles = getExportedFiles();
+      const componentsWithDocs = getComponentsWithDocs(allComponents, exportedFiles);
+      return {
+        componentsWithDocs,
+        exportedFiles
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to initialize get component docs tool: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  },
+  exec(server2, { ctx, name, description }) {
+    server2.tool(
+      name,
+      description,
+      {
+        component: z.enum(ctx.componentsWithDocs).describe("The name of the SDS component to get documentation for")
+      },
+      async ({ component }) => {
+        try {
+          const mappedFile = mapComponentToFile(component, ctx.exportedFiles);
+          if (!mappedFile) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `No documentation found for component '${component}'. This component may not have design system documentation available.`
+                }
+              ]
+            };
+          }
+          const possiblePaths = [
+            path.join(dirname2, "../../data/zeroheight-exports", mappedFile),
+            // From src/lib in dev
+            path.join(dirname2, "../data/zeroheight-exports", mappedFile),
+            // From dist in prod
+            path.join(process.cwd(), "data/zeroheight-exports", mappedFile)
+            // From current working directory
+          ];
+          let filePath = "";
+          for (const p of possiblePaths) {
+            if (fs.existsSync(p)) {
+              filePath = p;
+              break;
+            }
+          }
+          if (!filePath) {
+            throw new Error(`Documentation file ${mappedFile} not found`);
+          }
+          const documentation = fs.readFileSync(filePath, "utf8");
+          return {
+            content: [
+              {
+                type: "text",
+                text: `# Documentation for ${component}
+
+Source: ${mappedFile}
+
+${documentation}`
+              }
+            ]
+          };
+        } catch (error) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error reading documentation file for '${component}': ${error instanceof Error ? error.message : "Unknown error"}`
+              }
+            ]
+          };
+        }
+      }
+    );
+  }
+};
 
 // src/tools/index.ts
 var tools = [
   getComponentPropsTool,
   getComponentPropsStorybookTool,
+  getComponentDocsTool,
   listComponentsTool,
   getTailwindTokensTool
 ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@czi-sds/mcp",
   "description": "The official MCP server for SDS",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "main": "dist/stdio.js",
   "files": [
     "dist",
@@ -23,7 +23,8 @@
     "generate:components-list": "tsx scripts/generate-component-list.ts",
     "generate:component-props": "tsx scripts/generate-component-props.ts",
     "generate:component-props-storybook": "tsx scripts/generate-component-props-from-storybook.ts",
-    "generate:all": "yarn generate:tailwind-tokens && yarn generate:components-list && yarn generate:component-props && yarn generate:component-props-storybook",
+    "generate:zeroheight-export": "tsx scripts/export-zeroheight-pages.ts",
+    "generate:all": "yarn generate:tailwind-tokens && yarn generate:components-list && yarn generate:component-props && yarn generate:component-props-storybook && yarn generate:zeroheight-export",
     "prebuild": "yarn generate:all",
     "build": "yarn prebuild && tsup && chmod 755 dist/stdio.js",
     "dev": "tsup --watch",
@@ -62,5 +63,5 @@
     "tsx": "^4.20.3",
     "typescript": "^5.9.2"
   },
-  "gitHead": "34691ada3ef3cc877dcf1e2eef0f09efab53e668"
+  "gitHead": "c4bbb6751f8efd89ff5b6e560d8aea687cf8a84c"
 }