@lism-css/mcp 0.1.0 → 0.2.0

package/dist/tools/get-component.js

@@ -3,13 +3,17 @@ 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 }) => {
+    server.registerTool('get_component', {
+        description: '特定のlism-cssコンポーネントに関する詳細情報（プロパティ、使用例、カテゴリー）を取得します。該当するものが見つからない場合は、より広範なキーワードで search_docs を実行してください。',
+        inputSchema: {
+            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.'),
+        },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, ({ name, package: pkg }) => {
         try {
             const data = loadJSON('components.json', z.array(ComponentInfoSchema));
             let candidates = data;
@@ -17,10 +21,25 @@ export function registerGetComponent(server) {
                 candidates = data.filter((c) => c.package === pkg);
             }
             const nameLower = name.toLowerCase();
+            // Step 1: 名前の完全一致
             const exact = candidates.find((c) => c.name.toLowerCase() === nameLower);
             if (exact) {
                 return success({ component: exact });
             }
+            // Step 2: aliases マッチ（用途ベースの検索、完全一致）
+            const aliasMatches = candidates.filter((c) => c.aliases?.some((a) => a.toLowerCase() === nameLower));
+            if (aliasMatches.length === 1) {
+                return success({ component: aliasMatches[0], matchedBy: 'alias' });
+            }
+            if (aliasMatches.length > 1) {
+                const suggestions = aliasMatches.map((c) => ({
+                    name: c.name,
+                    package: c.package,
+                    description: c.description,
+                }));
+                return notFound(`Component "${name}" not found by name, but ${aliasMatches.length} components matched by alias. Did you mean one of these?`, { suggestions });
+            }
+            // Step 3: 名前の部分一致
             const suggestions = candidates
                 .filter((c) => c.name.toLowerCase().includes(nameLower))
                 .map((c) => ({ name: c.name, package: c.package }));

package/dist/tools/get-overview.js

@@ -38,7 +38,10 @@ function toMarkdown(data) {
     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, () => {
+    server.registerTool('get_overview', {
+        description: '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.',
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, () => {
         try {
             const data = loadJSON('overview.json', OverviewDataSchema);
             return markdownResponse(toMarkdown(data));

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

@@ -2,26 +2,51 @@ 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';
+/** cssProperty フィールドからコア名を抽出（例: "--hl (CSS変数)" → "--hl"） */
+function normalizeCssProperty(raw) {
+    // "(class: is--container)" → "is--container"
+    const classMatch = raw.match(/\(class:\s*(.+?)\)/);
+    if (classMatch)
+        return classMatch[1].trim().toLowerCase();
+    // "--hl (CSS変数)" → "--hl"
+    return raw.replace(/\s*\(.*\)$/, '').trim().toLowerCase();
+}
 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 }) => {
+    server.registerTool('get_props_system', {
+        description: 'Get the lism-css Props system reference: how React/Astro props map to CSS classes and styles. Supports lookup by lism prop name (e.g. "p", "fz") OR by CSS property name (e.g. "padding", "font-size"). Use this for CSS-to-lism reverse lookup. Related: use convert_css for bulk CSS conversion, get_component to see how props are used in components.',
+        inputSchema: {
+            prop: z
+                .string()
+                .optional()
+                .describe('Prop name or CSS property name to look up. Accepts lism prop names (e.g. "p", "fz", "bgc") and standard CSS property names (e.g. "padding", "font-size", "background-color"). Omit to get the full system overview.'),
+        },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, ({ prop }) => {
         try {
             const data = loadJSON('props-system.json', PropsSystemDataSchema);
             if (!prop) {
                 return success(data);
             }
-            const propLower = prop.toLowerCase();
+            const queryLower = prop.toLowerCase();
             const matched = [];
             for (const cat of data.categories) {
-                const found = cat.props.filter((p) => p.prop.toLowerCase() === propLower);
+                const found = cat.props.filter((p) => {
+                    // Lism prop 名で一致
+                    if (p.prop.toLowerCase() === queryLower)
+                        return true;
+                    // CSS プロパティ名で一致（逆引き）
+                    const normalizedCss = normalizeCssProperty(p.cssProperty);
+                    if (normalizedCss === queryLower)
+                        return true;
+                    return false;
+                });
                 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 });
+                const allProps = data.categories.flatMap((c) => c.props.map((p) => `${p.prop} (${p.cssProperty})`));
+                return notFound(`"${prop}" に一致する Prop が見つかりません。Lism prop 名 (例: "p", "fz") または CSS プロパティ名 (例: "padding", "font-size") で検索できます。`, { availableProps: allProps });
             }
             return success({ description: data.description, categories: matched });
         }

package/dist/tools/get-tokens.js

@@ -4,9 +4,13 @@ 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 }) => {
+    server.registerTool('get_tokens', {
+        description: '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.',
+        inputSchema: {
+            category: z.enum(TOKEN_CATEGORIES).default('all').describe('Token category to retrieve. Use "all" to get all categories.'),
+        },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, ({ category }) => {
         try {
             const data = loadJSON('tokens.json', z.array(TokenCategorySchema));
             const filtered = category === 'all' ? data : data.filter((c) => c.category === category);

package/dist/tools/search-docs.js

@@ -1,18 +1,26 @@
 import { z } from 'zod';
 import { loadJSON } from '../lib/load-data.js';
-import { DocsEntrySchema } from '../lib/schemas.js';
-import { searchDocs } from '../lib/search.js';
+import { DocsEntrySchema, ComponentInfoSchema, PropsSystemDataSchema } from '../lib/schemas.js';
+import { buildAliasMap, buildCssPropertyMap, 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 }) => {
+    server.registerTool('search_docs', {
+        description: "Search lism-css documentation by keyword. Returns matching pages with relevance scores. Supports CSS property names (e.g. 'font-size', 'padding') which are automatically expanded to corresponding lism prop names. Use this when other tools don't return the information you need, or to discover available components and features.",
+        inputSchema: {
+            query: z.string().describe('Search query (keywords separated by spaces). CSS property names like "font-size" are also accepted.'),
+            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.'),
+        },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, ({ query, category, limit }) => {
         try {
             const entries = loadJSON('docs-index.json', z.array(DocsEntrySchema));
-            const results = searchDocs(entries, query, category, limit);
+            const components = loadJSON('components.json', z.array(ComponentInfoSchema));
+            const propsData = loadJSON('props-system.json', PropsSystemDataSchema);
+            const aliasMap = buildAliasMap(components);
+            const cssPropertyMap = buildCssPropertyMap(propsData.categories);
+            const results = searchDocs(entries, query, { category, limit, aliasMap, cssPropertyMap });
             return success({ query, results });
         }
         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lism-css/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for lism-css documentation and API reference.",
   "type": "module",
   "bin": {
@@ -12,13 +12,13 @@
     "bin"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.18.1",
-    "zod": "^3.24.0"
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^22.19.15",
     "typescript": "~5.8.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "license": "MIT",
   "scripts": {