@lism-css/mcp 0.10.4 → 0.12.0

package/dist/tools/search-docs.js

@@ -1,12 +1,33 @@
 import { z } from 'zod';
 import { loadJSON } from '../lib/load-data.js';
-import { DocsEntrySchema, ComponentInfoSchema, PropsSystemDataSchema } from '../lib/schemas.js';
-import { buildAliasMap, buildCssPropertyMap, searchDocs } from '../lib/search.js';
+import { loadMarkdown } from '../lib/load-markdown.js';
+import { DocsEntrySchema } from '../lib/schemas.js';
+import { parsePropRows } from '../lib/markdown-utils.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'];
+/**
+ * property-class.md のテーブルから CSSプロパティ名 → Lism prop名 のマップを構築する。
+ * search.ts の buildCssPropertyMap と同じインターフェースを返す。
+ */
+function buildCssPropertyMapFromMarkdown(md) {
+    const map = new Map();
+    for (const row of parsePropRows(md)) {
+        const normalized = row.cssProperty.toLowerCase();
+        if (normalized.startsWith('(class:'))
+            continue;
+        const existing = map.get(normalized) ?? [];
+        existing.push(row.prop.toLowerCase());
+        map.set(normalized, existing);
+    }
+    return map;
+}
 export function registerSearchDocs(server) {
     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.",
+        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.\n" +
+            'Use this when you cannot find information with other tools, or to discover available components, features, and guides by keyword.\n' +
+            'Do NOT use this as your first step — prefer get_component for a known component, get_props_system for a known prop, or get_guide for a specific topic. This is a fallback search tool.\n' +
+            'Returns JSON with search results including page URLs and relevance scores.',
         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.'),
@@ -16,15 +37,12 @@ export function registerSearchDocs(server) {
     }, ({ query, category, limit }) => {
         try {
             const entries = loadJSON('docs-index.json', z.array(DocsEntrySchema));
-            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 });
+            const cssPropertyMap = buildCssPropertyMapFromMarkdown(loadMarkdown('property-class.md'));
+            const results = searchDocs(entries, query, { category, limit, cssPropertyMap });
             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.`);
+            return error(`Failed to search docs: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Run "pnpm build" in packages/mcp first.`);
         }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lism-css/mcp",
-  "version": "0.10.4",
+  "version": "0.12.0",
   "description": "MCP server for lism-css documentation and API reference.",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
   "license": "MIT",
   "scripts": {
     "format": "prettier --write . --ignore-path ../../.prettierignore",
-    "build": "tsc -p tsconfig.build.json && cp src/data/*.json dist/data/",
+    "build": "tsc -p tsconfig.build.json && cp src/data/docs-index.json dist/data/ && rm -rf dist/data/guides && cp -r ../../.claude/skills/lism-css-guide dist/data/guides",
     "dev": "tsc --watch",
     "test": "vitest run"
   }