@gostudent/shared-ui-library-mcp 1.23.2-DT-16968

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@gostudent/shared-ui-library-mcp",
+  "version": "1.23.2-DT-16968",
+  "description": "MCP server for @gostudent/shared-ui-library — exposes components, icons, and tokens to Claude",
+  "type": "module",
+  "bin": {
+    "shared-ui-library-mcp": "./server.mjs"
+  },
+  "main": "./server.mjs",
+  "files": [
+    "server.mjs",
+    "library-manifest.json"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/server.mjs

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * Library MCP server for @gostudent/shared-ui-library.
+ * Exposes components, icons, and tokens to Claude via stdio.
+ *
+ * Usage: npx @gostudent/shared-ui-library-mcp@latest
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+let manifest;
+try {
+  manifest = JSON.parse(readFileSync(join(__dirname, 'library-manifest.json'), 'utf8'));
+} catch (err) {
+  process.stderr.write(
+    'shared-ui-library-mcp: could not read library-manifest.json.\n' +
+    'If running from source, run `npm run build:mcp-manifest` first.\n'
+  );
+  process.exit(1);
+}
+
+const server = new McpServer({
+  name: 'shared-ui-library',
+  version: manifest.libraryVersion,
+});
+
+// ─── list_components ──────────────────────────────────────────────────────────
+
+server.registerTool(
+  'list_components',
+  {
+    description: 'List all available components with their descriptions.',
+    inputSchema: {},
+  },
+  async () => {
+    const list = manifest.components.map(c => ({
+      name: c.name,
+      description: c.description,
+    }));
+    return {
+      content: [{ type: 'text', text: JSON.stringify(list, null, 2) }],
+    };
+  },
+);
+
+// ─── get_component ────────────────────────────────────────────────────────────
+
+server.registerTool(
+  'get_component',
+  {
+    description: 'Get full details for a component: props, variants, and usage examples.',
+    inputSchema: {
+      name: z.string().describe('Component name, e.g. "Button"'),
+    },
+  },
+  async ({ name }) => {
+    const component = manifest.components.find(
+      c => c.name.toLowerCase() === name.toLowerCase(),
+    );
+    if (!component) {
+      return {
+        content: [{ type: 'text', text: `Component "${name}" not found. Use list_components to see available components.` }],
+      };
+    }
+    return {
+      content: [{ type: 'text', text: JSON.stringify(component, null, 2) }],
+    };
+  },
+);
+
+// ─── list_icons ───────────────────────────────────────────────────────────────
+
+server.registerTool(
+  'list_icons',
+  {
+    description: 'List all available icon names and their supported sizes.',
+    inputSchema: {},
+  },
+  async () => {
+    return {
+      content: [{ type: 'text', text: JSON.stringify(manifest.icons, null, 2) }],
+    };
+  },
+);
+
+// ─── get_tokens ───────────────────────────────────────────────────────────────
+
+server.registerTool(
+  'get_tokens',
+  {
+    description: 'Get design tokens. Optionally filter by category (e.g. "spacing", "color", "font") and brand ("base", "gs", "sk").',
+    inputSchema: {
+      category: z.string().optional().describe('Token category prefix, e.g. "spacing", "color", "font", "radius"'),
+      brand: z.enum(['base', 'gs', 'sk']).optional().describe('Brand token set. Defaults to "base".'),
+    },
+  },
+  async ({ category, brand = 'base' }) => {
+    const brandTokens = manifest.tokens[brand];
+    if (!brandTokens) {
+      return {
+        content: [{ type: 'text', text: `Unknown brand "${brand}". Use "base", "gs", or "sk".` }],
+      };
+    }
+    const result = category
+      ? { [category]: brandTokens[category] ?? {} }
+      : brandTokens;
+    return {
+      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+  },
+);
+
+// ─── search_components ────────────────────────────────────────────────────────
+
+server.registerTool(
+  'search_components',
+  {
+    description: 'Search components by name, description, or prop names.',
+    inputSchema: {
+      query: z.string().describe('Search term, e.g. "button", "dropdown", "size"'),
+    },
+  },
+  async ({ query }) => {
+    const q = query.toLowerCase();
+    const matches = manifest.components.filter(c => {
+      if (c.name.toLowerCase().includes(q)) return true;
+      if (c.description.toLowerCase().includes(q)) return true;
+      if (c.props.some(p => p.name.toLowerCase().includes(q) || p.description.toLowerCase().includes(q))) return true;
+      return false;
+    }).map(c => ({ name: c.name, description: c.description }));
+
+    return {
+      content: [{
+        type: 'text',
+        text: matches.length
+          ? JSON.stringify(matches, null, 2)
+          : `No components found matching "${query}".`,
+      }],
+    };
+  },
+);
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`shared-ui-library MCP v${manifest.libraryVersion} running on stdio`);
+}
+
+main().catch(err => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});