@lism-css/mcp 0.23.0 → 0.26.0

package/dist/lib/search.js

@@ -67,7 +67,7 @@ function scoreEntry(entry, queryTokens) {
     return score;
 }
 export function searchDocs(entries, query, options) {
-    const { category, limit = 10, cssPropertyMap } = options ?? {};
+    const { category, limit = 10, cssPropertyMap, guideTopics } = options ?? {};
     // CSSプロパティ名・Property Class記法をLism prop名に展開してからトークナイズ
     const expandedQuery = expandQuery(query, cssPropertyMap);
     const queryTokens = tokenize(expandedQuery);
@@ -85,15 +85,67 @@ export function searchDocs(entries, query, options) {
         .filter(({ score }) => score > 0)
         .sort((a, b) => b.score - a.score)
         .slice(0, limit);
-    const DOCS_BASE_URL = 'https://lism-css.com/docs';
     return scored.map(({ entry, score }) => ({
         sourcePath: entry.sourcePath,
-        url: `${DOCS_BASE_URL}/${sourcePathToUrlSlug(entry.sourcePath)}/`,
+        url: slugToPageUrl(sourcePathToUrlSlug(entry.sourcePath)),
         heading: entry.title,
         snippet: entry.snippet,
         score,
+        nextTool: getNextTool(entry, guideTopics),
     }));
 }
+const SITE_BASE_URL = 'https://lism-css.com';
+/**
+ * URL スラッグを公開ページの URL に変換する。
+ * `ui/` 配下はサイト直下（`/ui/...`）、それ以外は `/docs/` 配下で公開される
+ * （apps/docs の `getPostUrl` と同じルーティング規則）。
+ */
+function slugToPageUrl(slug) {
+    return slug.startsWith('ui/') ? `${SITE_BASE_URL}/${slug}/` : `${SITE_BASE_URL}/docs/${slug}/`;
+}
+/** `sourcePath`（拡張子なし）の末尾セグメントを返す（例: `primitives/l--flex` → `l--flex`） */
+function getBasename(withoutExt) {
+    const parts = withoutExt.split('/');
+    return parts[parts.length - 1];
+}
+/**
+ * 検索結果のページを詳しく見るための推奨フォローアップツール呼び出しを返す。
+ * sourcePath による判定をカテゴリによる判定より優先する。
+ */
+function getNextTool(entry, guideTopics) {
+    const withoutExt = entry.sourcePath.replace(/\.mdx$/, '');
+    const basename = getBasename(withoutExt);
+    // sourcePath ベースの判定（category より優先）
+    if (withoutExt === 'core-components/lism-props') {
+        return 'get_props_system()';
+    }
+    if (withoutExt.startsWith('primitives/') || withoutExt.startsWith('trait-class/')) {
+        return `get_component(name: "${basename}")`;
+    }
+    if (withoutExt === 'property-class') {
+        return 'get_guide(topic: "property-class")';
+    }
+    if (withoutExt.startsWith('property-class/')) {
+        return `get_props_system(prop: "${basename}")`;
+    }
+    // ui/block-examples/（Chat, Timeline 等）と ui/components/（Card, Hero 等）は、
+    // パッケージが提供するコンポーネントではなく Lism CSS での実装例ページなので get_component では解決できない。
+    // 詳細が必要な場合は検索結果の url を参照してもらう。
+    if (withoutExt.startsWith('ui/block-examples/') || withoutExt.startsWith('ui/components/')) {
+        return null;
+    }
+    // category ベースの判定
+    switch (entry.category) {
+        case 'core-components':
+            return `get_component(name: "${basename}")`;
+        case 'ui':
+            return `get_component(name: "${basename}", package: "@lism-css/ui")`;
+        case 'guide':
+            return guideTopics?.has(basename) ? `get_guide(topic: "${basename}")` : null;
+        default:
+            return null;
+    }
+}
 /**
  * `sourcePath`（実 MDX ファイルの相対パス）を公開 URL のスラッグに変換する。
  *
@@ -112,7 +164,7 @@ export function searchDocs(entries, query, options) {
  *   `ui/DummyText.mdx`              → `ui/dummytext`
  */
 const PRESERVE_CASE_PREFIXES = ['primitives/', 'trait-class/'];
-function sourcePathToUrlSlug(sourcePath) {
+export function sourcePathToUrlSlug(sourcePath) {
     const withoutExt = sourcePath.replace(/\.mdx$/, '');
     return PRESERVE_CASE_PREFIXES.some((prefix) => withoutExt.startsWith(prefix)) ? withoutExt : withoutExt.toLowerCase();
 }

package/dist/lib/types.d.ts

@@ -1,21 +1,5 @@
-export interface MetaInfo {
-    generatedAt: string;
-    sourceCommit: string;
-    docsVersion: string;
-}
-export interface SearchResult {
-    sourcePath: string;
-    url: string;
-    heading: string;
-    snippet: string;
-    score: number;
-}
-export interface DocsEntry {
-    sourcePath: string;
-    title: string;
-    description: string;
-    category: string;
-    headings: string[];
-    keywords: string[];
-    snippet: string;
-}
+import type { z } from 'zod';
+import type { MetaInfoSchema, DocsEntrySchema, SearchResultSchema } from './schemas.js';
+export type MetaInfo = z.infer<typeof MetaInfoSchema>;
+export type SearchResult = z.infer<typeof SearchResultSchema>;
+export type DocsEntry = z.infer<typeof DocsEntrySchema>;

package/dist/lib/version.d.ts

@@ -0,0 +1,2 @@
+/** package.json の version（サーバーが名乗るバージョンの単一情報源） */
+export declare const packageVersion: string;

package/dist/lib/version.js

@@ -0,0 +1,8 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// src/lib/（開発時）と dist/lib/（ビルド後）のどちらから見ても package.json は 2 つ上の階層にある
+const pkgPath = resolve(__dirname, '..', '..', 'package.json');
+/** package.json の version（サーバーが名乗るバージョンの単一情報源） */
+export const packageVersion = JSON.parse(readFileSync(pkgPath, 'utf-8')).version;

package/dist/tools/convert-css.js

@@ -1,7 +1,23 @@
 import { z } from 'zod';
-import { loadMarkdown } from '../lib/load-markdown.js';
+import { loadPropsMarkdown } from '../lib/load-markdown.js';
 import { parsePropRows } from '../lib/markdown-utils.js';
+import { MetaInfoSchema } from '../lib/schemas.js';
 import { success, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+/** 変換結果の1行 */
+const ConversionEntrySchema = z.object({
+    css: z.string(),
+    lismProp: z.string().nullable(),
+    suggestedValue: z.string().nullable(),
+    availableTokens: z.array(z.string()).nullable(),
+    confidence: z.enum(['exact', 'approximate', 'unmapped']),
+    note: z.string(),
+});
+/** コンポーネント提案 */
+const ComponentSuggestionSchema = z.object({
+    name: z.string(),
+    reason: z.string(),
+    implicitCss: z.array(z.string()),
+});
 // ----------------------------------------------------------------
 // CSS パース
 // ----------------------------------------------------------------
@@ -9,7 +25,7 @@ import { success, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
 function detectAtRules(cssText) {
     const atRuleMatch = cssText.match(/^@(\w[\w-]*)/m);
     if (atRuleMatch) {
-        return `@${atRuleMatch[1]} ルールは未対応です。CSS 宣言（property: value;）のみを入力してください。`;
+        return `@${atRuleMatch[1]} rules are not supported. Provide plain CSS declarations (property: value;) only.`;
     }
     return null;
 }
@@ -124,7 +140,7 @@ function detectComponent(declarations) {
     if (display === 'flex' && (flexDirection === 'column' || flexDirection === 'column-reverse')) {
         return {
             name: 'Stack',
-            reason: 'display: flex + flex-direction: column → Stack（縦積み Flex）',
+            reason: 'display: flex + flex-direction: column → Stack (vertical flex)',
             implicitCss: ['display: flex', 'flex-direction: column'],
         };
     }
@@ -132,7 +148,7 @@ function detectComponent(declarations) {
     if (display === 'grid' && placeItems === 'center') {
         return {
             name: 'Center',
-            reason: 'display: grid + place-items: center → Center（中央配置 Grid）',
+            reason: 'display: grid + place-items: center → Center (centered grid)',
             implicitCss: ['display: grid', 'place-items: center'],
         };
     }
@@ -140,7 +156,7 @@ function detectComponent(declarations) {
     if (display === 'flex') {
         return {
             name: 'Flex',
-            reason: 'display: flex → Flex コンポーネント',
+            reason: 'display: flex → Flex component',
             implicitCss: ['display: flex'],
         };
     }
@@ -148,7 +164,7 @@ function detectComponent(declarations) {
     if (display === 'grid') {
         return {
             name: 'Grid',
-            reason: 'display: grid → Grid コンポーネント',
+            reason: 'display: grid → Grid component',
             implicitCss: ['display: grid'],
         };
     }
@@ -206,6 +222,13 @@ export function registerConvertCss(server) {
                 .string()
                 .describe('CSS code to convert. Accepts a full rule block with selector (e.g. ".foo { padding: 1rem; }") or bare declarations (e.g. "padding: 1rem; font-size: 16px;"). @media and other at-rules are not supported.'),
         },
+        outputSchema: {
+            meta: MetaInfoSchema,
+            conversions: z.array(ConversionEntrySchema),
+            suggestedComponent: ComponentSuggestionSchema.nullable(),
+            example: z.string(),
+            tip: z.string(),
+        },
         annotations: READ_ONLY_ANNOTATIONS,
     }, ({ css }) => {
         try {
@@ -214,12 +237,12 @@ export function registerConvertCss(server) {
             if (atRuleError) {
                 return error(atRuleError);
             }
-            const md = loadMarkdown('property-class.md');
+            const md = loadPropsMarkdown();
             const mappings = buildMappings(md);
             const cssPropertyMap = buildCssPropertyMap(mappings);
             const declarations = parseCssDeclarations(css);
             if (declarations.length === 0) {
-                return error('CSS 宣言が見つかりません。"property: value;" 形式の CSS を入力してください。');
+                return error('No CSS declarations found. Provide CSS in "property: value;" format.');
             }
             // 各宣言を変換
             const conversions = declarations.map((decl) => {
@@ -231,7 +254,7 @@ export function registerConvertCss(server) {
                         suggestedValue: null,
                         availableTokens: null,
                         confidence: 'unmapped',
-                        note: 'Lism Props に該当なし。style で直接指定してください。',
+                        note: 'No matching Lism prop. Specify it directly via the style attribute.',
                     };
                 }
                 const suggested = suggestValue(mapping, decl.value);
@@ -243,10 +266,10 @@ export function registerConvertCss(server) {
                     availableTokens: mapping.presetValues.length > 0 ? mapping.presetValues : null,
                     confidence: suggested ? 'exact' : 'approximate',
                     note: suggested
-                        ? `トークン値 '${suggested}' を使用（カテゴリ: ${category}）`
+                        ? `Use token value '${suggested}' (category: ${category})`
                         : mapping.presetValues.length > 0
-                            ? `カスタム値。利用可能なトークン: ${mapping.presetValues.join(', ')}（カテゴリ: ${category}）`
-                            : `カスタム値として指定（カテゴリ: ${category}）`,
+                            ? `Custom value. Available tokens: ${mapping.presetValues.join(', ')} (category: ${category})`
+                            : `Use as a custom value (category: ${category})`,
                 };
             });
             // コンポーネント検出
@@ -257,11 +280,11 @@ export function registerConvertCss(server) {
                 conversions,
                 suggestedComponent,
                 example,
-                tip: 'トークン値にマッチしない値は style 属性で CSS 変数として指定できます（例: style="--p: 1rem"）。get_props_system で各 prop の詳細を確認できます。',
+                tip: 'Values that do not match a token can be set as CSS variables via the style attribute (e.g. style="--p: 1rem"). Use get_props_system for details on each prop.',
             });
         }
         catch (e) {
-            return error(`CSS 変換に失敗しました: ${e instanceof Error ? e.message : String(e)}`);
+            return error(`CSS conversion failed: ${e instanceof Error ? e.message : String(e)}`);
         }
     });
 }

package/dist/tools/get-component.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { getGuideFilenames, loadMarkdown } from '../lib/load-markdown.js';
 import { findComponentByHeading, findComponentInTables } from '../lib/markdown-utils.js';
-import { markdownResponse, error, notFound, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { markdownResponse, loadFailureError, notFound, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
 /** 入力を正規化してエイリアス検索のキーに変換する。
  *  `<Flex>` / `Flex` / `l--flex` / `flex` をすべて `flex` に揃える。 */
 function normalizeComponentKey(input) {
@@ -171,7 +171,7 @@ export function registerGetComponent(server) {
             });
         }
         catch (e) {
-            return error(`Failed to load component data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Run "pnpm build" in packages/mcp first.`);
+            return loadFailureError('component data', e);
         }
     });
 }

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

@@ -1,2 +1,4 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** get_guide が受理するトピックキーの集合。search.ts の nextTool 判定で利用する。 */
+export declare const GUIDE_TOPIC_KEYS: ReadonlySet<string>;
 export declare function registerGetGuide(server: McpServer): void;

package/dist/tools/get-guide.js

@@ -1,32 +1,55 @@
 import { z } from 'zod';
 import { loadMarkdown } from '../lib/load-markdown.js';
-import { markdownResponse, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { markdownResponse, loadFailureError, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+// files に複数指定したトピックは結合して返す。
+// MCP クライアントは Markdown 内の相対リンクを辿れないため、分冊ファイルは本体に結合する。
 const GUIDE_TOPICS = {
-    overview: { file: 'SKILL.md', label: 'Framework overview, packages, implementation rules' },
-    tokens: { file: 'tokens.md', label: 'Design tokens (spacing, colors, font sizes, etc.)' },
-    'property-class': { file: 'property-class.md', label: 'Property Class system, all props reference table' },
+    overview: { files: ['SKILL.md'], label: 'Framework overview, packages, implementation rules' },
+    tokens: { files: ['tokens.md'], label: 'Design tokens (spacing, colors, font sizes, etc.)' },
+    'property-class': {
+        files: ['property-class.md', 'property-class/all-props.md', 'property-class/bd.md', 'property-class/hov.md', 'property-class/max-sz.md'],
+        label: 'Property Class system, all props reference table, border (bd) / hover (hov) / max-sz details',
+    },
     'components-core': {
-        file: 'components-core.md',
+        files: ['components-core.md'],
         label: 'Core component system (Lism, Box, Flex, Stack, Grid, etc.)',
     },
     'components-ui': {
-        file: 'components-ui.md',
+        files: ['components-ui.md'],
         label: 'UI components (Accordion, Modal, Tabs, Button, etc.)',
     },
-    'base-styles': { file: 'base-styles.md', label: 'Base styling, reset CSS, HTML element styles' },
-    'set-class': { file: 'set-class.md', label: 'Set classes (set--plain, set--bxsh, set--hov, etc.)' },
+    'base-styles': { files: ['base-styles.md'], label: 'Base styling, reset CSS, HTML element styles' },
+    'set-class': { files: ['set-class.md'], label: 'Set classes (set--plain, set--bxsh, set--hov, etc.)' },
     'primitive-class': {
-        file: 'primitive-class.md',
-        label: 'Primitive class prefixes (is--, l--, a--) and Component class (c--), with column-layout primitive selection guide',
+        files: ['primitive-class.md'],
+        label: 'Primitive class prefixes (l--, a--), with column-layout primitive selection guide',
+    },
+    'trait-class': {
+        files: ['trait-class.md'],
+        label: 'Trait classes (is--, has--): declarative role/feature classes in the lism-trait layer',
+    },
+    'utility-class': { files: ['utility-class.md'], label: 'Utility classes (u--trim, u--cbox, etc.)' },
+    'css-rules': { files: ['css-rules.md'], label: 'CSS methodology, layer structure, Block Class (b--) / Custom Class (c--), naming conventions' },
+    naming: {
+        files: ['naming.md'],
+        label: 'Naming conventions: CSS variable / class naming rules, {prop} and {value} abbreviation rules',
+    },
+    responsive: { files: ['responsive.md'], label: 'Responsive design, breakpoints, container queries' },
+    customize: {
+        files: ['customize.md'],
+        label: 'Customization: @layer opt-out, SCSS settings, lism.config.js, CSS purge',
     },
-    'utility-class': { file: 'utility-class.md', label: 'Utility classes (u--trim, u--cbox, etc.)' },
-    'css-rules': { file: 'css-rules.md', label: 'CSS methodology, layer structure, naming conventions' },
-    responsive: { file: 'responsive.md', label: 'Responsive design, breakpoints, container queries' },
     antipatterns: {
-        file: 'antipatterns.md',
-        label: 'AI code-generation antipatterns: token typos, prop type mistakes, layout choice errors, responsive omissions',
+        files: ['antipatterns.md'],
+        label: 'AI code-generation antipatterns (values / style declarations): px hardcoding, token typos, keycolor misuse, prop type mistakes',
+    },
+    'antipatterns-layout': {
+        files: ['antipatterns-layout.md'],
+        label: 'AI code-generation antipatterns (structure / layout / responsive): layout choice errors, responsive omissions, is-- misuse, naming mistakes',
     },
 };
+/** get_guide が受理するトピックキーの集合。search.ts の nextTool 判定で利用する。 */
+export const GUIDE_TOPIC_KEYS = new Set(Object.keys(GUIDE_TOPICS));
 const TOPIC_DESCRIPTION = Object.entries(GUIDE_TOPICS)
     .map(([key, { label }]) => `- ${key}: ${label}`)
     .join('\n');
@@ -42,11 +65,11 @@ export function registerGetGuide(server) {
         annotations: READ_ONLY_ANNOTATIONS,
     }, ({ topic }) => {
         try {
-            const { file } = GUIDE_TOPICS[topic];
-            return markdownResponse(loadMarkdown(file));
+            const { files } = GUIDE_TOPICS[topic];
+            return markdownResponse(files.map((file) => loadMarkdown(file)).join('\n\n'));
         }
         catch (e) {
-            return error(`Failed to load guide "${topic}": ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Run "pnpm build" in packages/mcp first.`);
+            return loadFailureError(`guide "${topic}"`, e);
         }
     });
 }

package/dist/tools/get-overview.js

@@ -1,6 +1,6 @@
 import { loadMarkdown } from '../lib/load-markdown.js';
 import { extractSection } from '../lib/markdown-utils.js';
-import { markdownResponse, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { markdownResponse, loadFailureError, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
 /**
  * SKILL.md を中核に、css-rules.md の Layer 構造セクションと
  * responsive.md のブレイクポイントセクションを付加して返す。
@@ -34,7 +34,7 @@ export function registerGetOverview(server) {
             return markdownResponse(buildOverviewMarkdown());
         }
         catch (e) {
-            return error(`Failed to load overview data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Run "pnpm build" in packages/mcp first.`);
+            return loadFailureError('overview data', e);
         }
     });
 }

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

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { loadMarkdown } from '../lib/load-markdown.js';
+import { loadPropsMarkdown } from '../lib/load-markdown.js';
 import { parsePropRows } from '../lib/markdown-utils.js';
 import { parsePropClassName } from '../lib/search.js';
-import { markdownResponse, error, notFound, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { markdownResponse, loadFailureError, notFound, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
 /** cssProperty フィールドからコア名を抽出（"--hl 変数のみ" → "--hl"） */
 function normalizeCssProperty(raw) {
     return raw
@@ -26,7 +26,7 @@ export function registerGetPropsSystem(server) {
         annotations: READ_ONLY_ANNOTATIONS,
     }, ({ prop }) => {
         try {
-            const md = loadMarkdown('property-class.md');
+            const md = loadPropsMarkdown();
             // prop 未指定: 全文を返す
             if (!prop) {
                 return markdownResponse(md);
@@ -44,13 +44,15 @@ export function registerGetPropsSystem(server) {
             });
             if (matched.length === 0) {
                 const availableProps = rows.map((r) => `${r.prop} (${r.cssProperty})`);
-                return notFound(`"${prop}" に一致する Prop が見つかりません。Lism prop 名 (例: "p", "fz") または CSS プロパティ名 (例: "padding", "font-size") で検索できます。`, { availableProps });
+                return notFound(`No prop matches "${prop}". Search by Lism prop name (e.g. "p", "fz") or CSS property name (e.g. "padding", "font-size").`, {
+                    availableProps,
+                });
             }
             // 一致したセクション名のユニーク一覧を取得
             const sections = [...new Set(matched.map((r) => r.sectionName))];
             // property-class.md から対象セクションを抽出して結合
             const lines = md.split('\n');
-            const resultParts = [`## 検索結果: "${prop}"\n`];
+            const resultParts = [`## Search results: "${prop}"\n`];
             for (const sectionName of sections) {
                 // セクション内の一致する行だけを含む簡易 Markdown を生成
                 const sectionRows = matched.filter((r) => r.sectionName === sectionName);
@@ -67,7 +69,7 @@ export function registerGetPropsSystem(server) {
             return markdownResponse(resultParts.join('\n\n'));
         }
         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. Run "pnpm build" in packages/mcp first.`);
+            return loadFailureError('props system data', e);
         }
     });
 }

package/dist/tools/get-tokens.js

@@ -1,5 +1,5 @@
 import { loadMarkdown } from '../lib/load-markdown.js';
-import { markdownResponse, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { markdownResponse, loadFailureError, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
 export function registerGetTokens(server) {
     server.registerTool('get_tokens', {
         description: 'Get design tokens (colors, spacing, font sizes, shadows, etc.) used in lism-css. Returns the full token reference including CSS variable names and available values.\n' +
@@ -12,7 +12,7 @@ export function registerGetTokens(server) {
             return markdownResponse(loadMarkdown('tokens.md'));
         }
         catch (e) {
-            return error(`Failed to load tokens data: ${e instanceof Error ? e.message : String(e)}. The data files may not be built yet. Run "pnpm build" in packages/mcp first.`);
+            return loadFailureError('tokens data', e);
         }
     });
 }

package/dist/tools/search-docs.js

@@ -1,10 +1,11 @@
 import { z } from 'zod';
 import { loadJSON } from '../lib/load-data.js';
-import { loadMarkdown } from '../lib/load-markdown.js';
-import { DocsEntrySchema } from '../lib/schemas.js';
+import { loadPropsMarkdown } from '../lib/load-markdown.js';
+import { DocsEntrySchema, MetaInfoSchema, SearchResultSchema } 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';
+import { success, loadFailureError, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
+import { GUIDE_TOPIC_KEYS } from './get-guide.js';
 const DOC_CATEGORIES = ['all', 'core-components', 'primitives', 'property-class', 'ui', 'guide'];
 /**
  * property-class.md のテーブルから CSSプロパティ名 → Lism prop名 のマップを構築する。
@@ -27,22 +28,27 @@ export function registerSearchDocs(server) {
         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.',
+            'Returns JSON with search results including page URLs and relevance scores. Each result includes a nextTool field with the recommended follow-up tool call for fetching that page in detail.',
         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.'),
         },
+        outputSchema: {
+            meta: MetaInfoSchema,
+            query: z.string(),
+            results: z.array(SearchResultSchema),
+        },
         annotations: READ_ONLY_ANNOTATIONS,
     }, ({ query, category, limit }) => {
         try {
             const entries = loadJSON('docs-index.json', z.array(DocsEntrySchema));
-            const cssPropertyMap = buildCssPropertyMapFromMarkdown(loadMarkdown('property-class.md'));
-            const results = searchDocs(entries, query, { category, limit, cssPropertyMap });
+            const cssPropertyMap = buildCssPropertyMapFromMarkdown(loadPropsMarkdown());
+            const results = searchDocs(entries, query, { category, limit, cssPropertyMap, guideTopics: GUIDE_TOPIC_KEYS });
             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. Run "pnpm build" in packages/mcp first.`);
+            return loadFailureError('docs search index', e);
         }
     });
 }

package/package.json

@@ -1,10 +1,22 @@
 {
   "name": "@lism-css/mcp",
-  "version": "0.23.0",
+  "version": "0.26.0",
   "description": "MCP server for lism-css documentation and API reference.",
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "lism-css",
+    "css",
+    "documentation"
+  ],
+  "homepage": "https://lism-css.com/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lism-css/lism-css/tree/main/packages/mcp"
+  },
   "type": "module",
   "bin": {
-    "mcp": "./bin/lism-mcp.mjs"
+    "lism-mcp": "./bin/lism-mcp.mjs"
   },
   "main": "./dist/index.js",
   "files": [
@@ -12,15 +24,18 @@
     "bin"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^25.0.0",
-    "typescript": "^5.8.3",
-    "vitest": "^4.1.0"
+    "@types/node": "^25.9.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   },
   "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "format": "prettier --write . --ignore-path ../../.prettierignore",
     "build": "tsc -p tsconfig.build.json && cp src/data/docs-index.json dist/data/ && rm -rf dist/data/guides && cp -r ../../skills/lism-css-guide dist/data/guides",