@lism-css/mcp 0.1.0

package/dist/tools/get-component.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { loadJSON } from '../lib/load-data.js';
+import { ComponentInfoSchema } from '../lib/schemas.js';
+import { success, error, notFound, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+export function registerGetComponent(server) {
+    server.tool('get_component', 'Get detailed information about a specific lism-css component: props, usage examples, and category. If not found, try search_docs with a broader query.', {
+        name: z.string().describe('Component name to look up (e.g. "Box", "Flex", "Accordion").'),
+        package: z
+            .enum(['lism-css', '@lism-css/ui'])
+            .optional()
+            .describe('Filter by package. "lism-css" for core components, "@lism-css/ui" for UI components.'),
+    }, READ_ONLY_ANNOTATIONS, ({ name, package: pkg }) => {
+        try {
+            const data = loadJSON('components.json', z.array(ComponentInfoSchema));
+            let candidates = data;
+            if (pkg) {
+                candidates = data.filter((c) => c.package === pkg);
+            }
+            const nameLower = name.toLowerCase();
+            const exact = candidates.find((c) => c.name.toLowerCase() === nameLower);
+            if (exact) {
+                return success({ component: exact });
+            }
+            const suggestions = candidates
+                .filter((c) => c.name.toLowerCase().includes(nameLower))
+                .map((c) => ({ name: c.name, package: c.package }));
+            if (suggestions.length > 0) {
+                return notFound(`Component "${name}" not found. Did you mean one of these? Or try search_docs with a broader query.`, {
+                    suggestions,
+                });
+            }
+            const available = candidates.map((c) => ({ name: c.name, package: c.package }));
+            return notFound(`Component "${name}" not found. Try search_docs to find related pages.`, { availableComponents: available });
+        }
+        catch (e) {
+            return error(`Failed to load component data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Ensure the server was installed correctly.`);
+        }
+    });
+}

package/dist/tools/get-overview.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetOverview(server: McpServer): void;

package/dist/tools/get-overview.js

@@ -0,0 +1,50 @@
+import { loadJSON } from '../lib/load-data.js';
+import { OverviewDataSchema } from '../lib/schemas.js';
+import { markdownResponse, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { meta } from '../data/meta.js';
+function toMarkdown(data) {
+    const lines = [];
+    lines.push(`# lism-css Overview`);
+    lines.push('');
+    lines.push(`> Generated at: ${meta.generatedAt} | Source commit: ${meta.sourceCommit} | Docs version: ${meta.docsVersion}`);
+    lines.push('');
+    lines.push(`## Description`);
+    lines.push('');
+    lines.push(data.description);
+    lines.push('');
+    lines.push(`## Architecture`);
+    lines.push('');
+    lines.push(data.architecture);
+    lines.push('');
+    lines.push(`## Packages`);
+    lines.push('');
+    for (const pkg of data.packages) {
+        lines.push(`- **${pkg.name}** (\`${pkg.npmName}\` v${pkg.version}): ${pkg.description}`);
+    }
+    lines.push('');
+    lines.push(`## Breakpoints`);
+    lines.push('');
+    for (const [key, value] of Object.entries(data.breakpoints)) {
+        lines.push(`- \`${key}\`: ${value}`);
+    }
+    lines.push('');
+    lines.push(`## CSS Layers`);
+    lines.push('');
+    lines.push(data.cssLayers);
+    lines.push('');
+    lines.push(`## Installation`);
+    lines.push('');
+    lines.push(data.installation);
+    return lines.join('\n');
+}
+export function registerGetOverview(server) {
+    server.tool('get_overview', 'Get an overview of the lism-css framework: architecture, design philosophy, packages, breakpoints, installation guide, and CSS layers. Start here to understand the framework before using other tools.', {}, READ_ONLY_ANNOTATIONS, () => {
+        try {
+            const data = loadJSON('overview.json', OverviewDataSchema);
+            return markdownResponse(toMarkdown(data));
+        }
+        catch (e) {
+            return error(`Failed to load overview data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Ensure the server was installed correctly.`);
+        }
+    });
+}

package/dist/tools/get-props-system.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetPropsSystem(server: McpServer): void;

package/dist/tools/get-props-system.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { loadJSON } from '../lib/load-data.js';
+import { PropsSystemDataSchema } from '../lib/schemas.js';
+import { success, error, notFound, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+export function registerGetPropsSystem(server) {
+    server.tool('get_props_system', 'Get the lism-css Props system reference: how React props map to CSS classes and styles. Optionally filter by a specific prop name. Related: use get_component to see how props are used in specific components.', {
+        prop: z.string().optional().describe('Specific prop name to look up (e.g. "p", "fz", "bgc"). Omit to get the full system overview.'),
+    }, READ_ONLY_ANNOTATIONS, ({ prop }) => {
+        try {
+            const data = loadJSON('props-system.json', PropsSystemDataSchema);
+            if (!prop) {
+                return success(data);
+            }
+            const propLower = prop.toLowerCase();
+            const matched = [];
+            for (const cat of data.categories) {
+                const found = cat.props.filter((p) => p.prop.toLowerCase() === propLower);
+                if (found.length > 0) {
+                    matched.push({ ...cat, props: found });
+                }
+            }
+            if (matched.length === 0) {
+                const allProps = data.categories.flatMap((c) => c.props.map((p) => p.prop));
+                return notFound(`Prop "${prop}" not found. Try search_docs to find related documentation.`, { availableProps: allProps });
+            }
+            return success({ description: data.description, categories: matched });
+        }
+        catch (e) {
+            return error(`Failed to load props system data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Ensure the server was installed correctly.`);
+        }
+    });
+}

package/dist/tools/get-tokens.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetTokens(server: McpServer): void;

package/dist/tools/get-tokens.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { loadJSON } from '../lib/load-data.js';
+import { TokenCategorySchema } from '../lib/schemas.js';
+import { success, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+const TOKEN_CATEGORIES = ['all', 'color', 'spacing', 'fontSize', 'shadow', 'radius', 'lineHeight', 'letterSpacing', 'fontFamily', 'zIndex'];
+export function registerGetTokens(server) {
+    server.tool('get_tokens', 'Get design tokens (colors, spacing, font sizes, shadows, etc.) used in lism-css. Use get_overview first to understand the framework, then use this tool to explore specific token categories.', {
+        category: z.enum(TOKEN_CATEGORIES).default('all').describe('Token category to retrieve. Use "all" to get all categories.'),
+    }, READ_ONLY_ANNOTATIONS, ({ category }) => {
+        try {
+            const data = loadJSON('tokens.json', z.array(TokenCategorySchema));
+            const filtered = category === 'all' ? data : data.filter((c) => c.category === category);
+            return success({ tokens: filtered });
+        }
+        catch (e) {
+            return error(`Failed to load tokens data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Ensure the server was installed correctly.`);
+        }
+    });
+}

package/dist/tools/search-docs.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchDocs(server: McpServer): void;

package/dist/tools/search-docs.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { loadJSON } from '../lib/load-data.js';
+import { DocsEntrySchema } from '../lib/schemas.js';
+import { searchDocs } from '../lib/search.js';
+import { success, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+const DOC_CATEGORIES = ['all', 'core-components', 'modules', 'props', 'ui', 'guide'];
+export function registerSearchDocs(server) {
+    server.tool('search_docs', "Search lism-css documentation by keyword. Returns matching pages with relevance scores. Use this when other tools don't return the information you need, or to discover available components and features.", {
+        query: z.string().describe('Search query (keywords separated by spaces).'),
+        category: z.enum(DOC_CATEGORIES).default('all').describe('Filter by documentation category.'),
+        limit: z.number().int().min(1).max(20).default(10).describe('Maximum number of results to return.'),
+    }, READ_ONLY_ANNOTATIONS, ({ query, category, limit }) => {
+        try {
+            const entries = loadJSON('docs-index.json', z.array(DocsEntrySchema));
+            const results = searchDocs(entries, query, category, limit);
+            return success({ query, results });
+        }
+        catch (e) {
+            return error(`Failed to search docs: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Ensure the server was installed correctly.`);
+        }
+    });
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@lism-css/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for lism-css documentation and API reference.",
+  "type": "module",
+  "bin": {
+    "lism-mcp": "./bin/lism-mcp.mjs"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "~5.8.3",
+    "vitest": "^4.0.18"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && cp src/data/*.json dist/data/",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  }
+}