@lism-css/mcp 0.1.0

package/dist/data/tokens.json

@@ -0,0 +1,131 @@
+[
+	{
+		"category": "color",
+		"description": "セマンティックカラートークン。サイト全体のカラー設計に使用。",
+		"tokens": [
+			{ "name": "--base", "value": "サイトの基本背景色", "description": "ベース背景色" },
+			{ "name": "--base-2", "value": "サイトの第2背景色", "description": "代替背景色" },
+			{ "name": "--text", "value": "メインのテキストカラー", "description": "基本テキスト色" },
+			{ "name": "--text-2", "value": "サブテキストカラー", "description": "補助テキスト色" },
+			{ "name": "--divider", "value": "ボーダー・区切り線の色", "description": "区切り線色" },
+			{ "name": "--link", "value": "リンクテキスト色", "description": "リンク色" },
+			{ "name": "--brand", "value": "ブランドカラー", "description": "ブランド色" },
+			{ "name": "--accent", "value": "アクセントカラー", "description": "アクセント色" }
+		]
+	},
+	{
+		"category": "color",
+		"description": "パレットカラートークン。装飾やバリエーションに使用。",
+		"tokens": [
+			{ "name": "--red", "value": "赤系カラー" },
+			{ "name": "--blue", "value": "青系カラー" },
+			{ "name": "--green", "value": "緑系カラー" },
+			{ "name": "--yellow", "value": "黄系カラー" },
+			{ "name": "--purple", "value": "紫系カラー" },
+			{ "name": "--orange", "value": "オレンジ系カラー" },
+			{ "name": "--pink", "value": "ピンク系カラー" },
+			{ "name": "--gray", "value": "グレー系カラー" },
+			{ "name": "--white", "value": "白" },
+			{ "name": "--black", "value": "黒" },
+			{ "name": "--keycolor", "value": "コンポーネントごとのキーカラー" }
+		]
+	},
+	{
+		"category": "spacing",
+		"description": "スペーシングトークン。padding, margin, gap 等で使用。CSS変数名は --s{値}。",
+		"tokens": [
+			{ "name": "--s5", "value": "最小の余白 (step 5)" },
+			{ "name": "--s10", "value": "余白 step 10" },
+			{ "name": "--s15", "value": "余白 step 15" },
+			{ "name": "--s20", "value": "余白 step 20" },
+			{ "name": "--s30", "value": "余白 step 30" },
+			{ "name": "--s40", "value": "余白 step 40" },
+			{ "name": "--s50", "value": "余白 step 50" },
+			{ "name": "--s60", "value": "余白 step 60" },
+			{ "name": "--s70", "value": "余白 step 70" },
+			{ "name": "--s80", "value": "最大の余白 (step 80)" }
+		]
+	},
+	{
+		"category": "fontSize",
+		"description": "フォントサイズトークン。CSS変数名は --fz--{値}。",
+		"tokens": [
+			{ "name": "--fz--root", "value": "ルートのフォントサイズ" },
+			{ "name": "--fz--base", "value": "本文の基本フォントサイズ" },
+			{ "name": "--fz--5xl", "value": "最大サイズ" },
+			{ "name": "--fz--4xl", "value": "特大サイズ" },
+			{ "name": "--fz--3xl", "value": "3XLサイズ" },
+			{ "name": "--fz--2xl", "value": "2XLサイズ" },
+			{ "name": "--fz--xl", "value": "XLサイズ" },
+			{ "name": "--fz--l", "value": "Lサイズ" },
+			{ "name": "--fz--m", "value": "Mサイズ" },
+			{ "name": "--fz--s", "value": "Sサイズ" },
+			{ "name": "--fz--xs", "value": "XSサイズ" },
+			{ "name": "--fz--2xs", "value": "最小サイズ" }
+		]
+	},
+	{
+		"category": "lineHeight",
+		"description": "行間 (heading line-height) トークン。CSS変数名は --hl--{値}。",
+		"tokens": [
+			{ "name": "--hl--base", "value": "基本の行間" },
+			{ "name": "--hl--xs", "value": "極小の行間" },
+			{ "name": "--hl--s", "value": "小さめの行間" },
+			{ "name": "--hl--l", "value": "大きめの行間" }
+		]
+	},
+	{
+		"category": "letterSpacing",
+		"description": "文字間隔トークン。CSS変数名は --lts--{値}。",
+		"tokens": [
+			{ "name": "--lts--base", "value": "基本の文字間隔" },
+			{ "name": "--lts--s", "value": "狭めの文字間隔" },
+			{ "name": "--lts--l", "value": "広めの文字間隔" }
+		]
+	},
+	{
+		"category": "fontFamily",
+		"description": "フォントファミリートークン。CSS変数名は --ff--{値}。",
+		"tokens": [
+			{ "name": "--ff--base", "value": "基本フォント" },
+			{ "name": "--ff--accent", "value": "アクセントフォント" },
+			{ "name": "--ff--mono", "value": "モノスペースフォント" }
+		]
+	},
+	{
+		"category": "radius",
+		"description": "角丸トークン。CSS変数名は --bdrs--{値}。段階的に値が大きくなる。",
+		"tokens": [
+			{ "name": "--bdrs--5", "value": "角丸 step 5" },
+			{ "name": "--bdrs--10", "value": "角丸 step 10" },
+			{ "name": "--bdrs--20", "value": "角丸 step 20" },
+			{ "name": "--bdrs--30", "value": "角丸 step 30" },
+			{ "name": "--bdrs--40", "value": "角丸 step 40" },
+			{ "name": "--bdrs--50", "value": "角丸 step 50" },
+			{ "name": "--bdrs--99", "value": "完全な丸 (pill)" },
+			{ "name": "--bdrs--inner", "value": "内側の角丸 (親要素に合わせる)" }
+		]
+	},
+	{
+		"category": "shadow",
+		"description": "ボックスシャドウトークン。CSS変数名は --bxsh--{値}。段階的に影が強くなる。",
+		"tokens": [
+			{ "name": "--bxsh--5", "value": "シャドウ step 5 (最も薄い)" },
+			{ "name": "--bxsh--10", "value": "シャドウ step 10" },
+			{ "name": "--bxsh--20", "value": "シャドウ step 20" },
+			{ "name": "--bxsh--30", "value": "シャドウ step 30" },
+			{ "name": "--bxsh--40", "value": "シャドウ step 40" },
+			{ "name": "--bxsh--50", "value": "シャドウ step 50 (最も濃い)" }
+		]
+	},
+	{
+		"category": "zIndex",
+		"description": "z-index プリセット値。",
+		"tokens": [
+			{ "name": "-1", "value": "-1" },
+			{ "name": "0", "value": "0" },
+			{ "name": "1", "value": "1" },
+			{ "name": "99", "value": "99" }
+		]
+	}
+]

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,26 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { preloadAll } from './lib/load-data.js';
+import { registerGetOverview } from './tools/get-overview.js';
+import { registerGetTokens } from './tools/get-tokens.js';
+import { registerGetPropsSystem } from './tools/get-props-system.js';
+import { registerGetComponent } from './tools/get-component.js';
+import { registerSearchDocs } from './tools/search-docs.js';
+async function main() {
+    preloadAll();
+    const server = new McpServer({
+        name: 'lism-css',
+        version: '0.1.0',
+    });
+    registerGetOverview(server);
+    registerGetTokens(server);
+    registerGetPropsSystem(server);
+    registerGetComponent(server);
+    registerSearchDocs(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('MCP server failed to start:', err);
+    process.exit(1);
+});

package/dist/lib/load-data.d.ts

@@ -0,0 +1,3 @@
+import type { ZodType } from 'zod';
+export declare function loadJSON<T>(filename: string, schema: ZodType<T>): T;
+export declare function preloadAll(): void;

package/dist/lib/load-data.js

@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { OverviewDataSchema, TokenCategorySchema, PropsSystemDataSchema, ComponentInfoSchema, DocsEntrySchema } from './schemas.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const dataDir = resolve(__dirname, '..', 'data');
+const cache = new Map();
+export function loadJSON(filename, schema) {
+    if (cache.has(filename))
+        return cache.get(filename);
+    const filePath = resolve(dataDir, filename);
+    const raw = readFileSync(filePath, 'utf-8');
+    const data = schema.parse(JSON.parse(raw));
+    cache.set(filename, data);
+    return data;
+}
+export function preloadAll() {
+    const entries = [
+        { filename: 'overview.json', schema: OverviewDataSchema },
+        { filename: 'tokens.json', schema: z.array(TokenCategorySchema) },
+        { filename: 'props-system.json', schema: PropsSystemDataSchema },
+        { filename: 'components.json', schema: z.array(ComponentInfoSchema) },
+        { filename: 'docs-index.json', schema: z.array(DocsEntrySchema) },
+    ];
+    for (const { filename, schema } of entries) {
+        loadJSON(filename, schema);
+    }
+}

package/dist/lib/response.d.ts

@@ -0,0 +1,14 @@
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+export declare const READ_ONLY_ANNOTATIONS: ToolAnnotations;
+type ToolResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+};
+export declare function success(data: Record<string, unknown>): ToolResult;
+export declare function notFound(message: string, extra?: Record<string, unknown>): ToolResult;
+export declare function error(message: string, extra?: Record<string, unknown>): ToolResult;
+export declare function markdownResponse(text: string): ToolResult;
+export {};

package/dist/lib/response.js

@@ -0,0 +1,28 @@
+import { meta } from '../data/meta.js';
+export const READ_ONLY_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+export function success(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ meta, ...data }, null, 2) }],
+    };
+}
+export function notFound(message, extra) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ meta, error: message, ...extra }, null, 2) }],
+    };
+}
+export function error(message, extra) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ meta, error: message, ...extra }, null, 2) }],
+        isError: true,
+    };
+}
+export function markdownResponse(text) {
+    return {
+        content: [{ type: 'text', text }],
+    };
+}

package/dist/lib/schemas.d.ts

@@ -0,0 +1,232 @@
+import { z } from 'zod';
+export declare const DocsEntrySchema: z.ZodObject<{
+    sourcePath: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodString;
+    headings: z.ZodArray<z.ZodString, "many">;
+    keywords: z.ZodArray<z.ZodString, "many">;
+    snippet: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sourcePath: string;
+    title: string;
+    description: string;
+    category: string;
+    headings: string[];
+    keywords: string[];
+    snippet: string;
+}, {
+    sourcePath: string;
+    title: string;
+    description: string;
+    category: string;
+    headings: string[];
+    keywords: string[];
+    snippet: string;
+}>;
+export declare const ComponentInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    package: z.ZodEnum<["lism-css", "@lism-css/ui"]>;
+    category: z.ZodString;
+    description: z.ZodString;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        default: z.ZodOptional<z.ZodString>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        type: string;
+        name: string;
+        default?: string | undefined;
+    }, {
+        description: string;
+        type: string;
+        name: string;
+        default?: string | undefined;
+    }>, "many">;
+    usage: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    category: string;
+    name: string;
+    package: "lism-css" | "@lism-css/ui";
+    props: {
+        description: string;
+        type: string;
+        name: string;
+        default?: string | undefined;
+    }[];
+    usage: string;
+}, {
+    description: string;
+    category: string;
+    name: string;
+    package: "lism-css" | "@lism-css/ui";
+    props: {
+        description: string;
+        type: string;
+        name: string;
+        default?: string | undefined;
+    }[];
+    usage: string;
+}>;
+export declare const TokenCategorySchema: z.ZodObject<{
+    category: z.ZodString;
+    description: z.ZodString;
+    tokens: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name: string;
+        description?: string | undefined;
+    }, {
+        value: string;
+        name: string;
+        description?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    category: string;
+    tokens: {
+        value: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+}, {
+    description: string;
+    category: string;
+    tokens: {
+        value: string;
+        name: string;
+        description?: string | undefined;
+    }[];
+}>;
+export declare const PropsSystemDataSchema: z.ZodObject<{
+    description: z.ZodString;
+    categories: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        description: z.ZodString;
+        props: z.ZodArray<z.ZodObject<{
+            prop: z.ZodString;
+            cssProperty: z.ZodString;
+            type: z.ZodString;
+            responsive: z.ZodBoolean;
+            description: z.ZodString;
+            values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            type: string;
+            prop: string;
+            cssProperty: string;
+            responsive: boolean;
+            values?: string[] | undefined;
+        }, {
+            description: string;
+            type: string;
+            prop: string;
+            cssProperty: string;
+            responsive: boolean;
+            values?: string[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        category: string;
+        props: {
+            description: string;
+            type: string;
+            prop: string;
+            cssProperty: string;
+            responsive: boolean;
+            values?: string[] | undefined;
+        }[];
+    }, {
+        description: string;
+        category: string;
+        props: {
+            description: string;
+            type: string;
+            prop: string;
+            cssProperty: string;
+            responsive: boolean;
+            values?: string[] | undefined;
+        }[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    categories: {
+        description: string;
+        category: string;
+        props: {
+            description: string;
+            type: string;
+            prop: string;
+            cssProperty: string;
+            responsive: boolean;
+            values?: string[] | undefined;
+        }[];
+    }[];
+}, {
+    description: string;
+    categories: {
+        description: string;
+        category: string;
+        props: {
+            description: string;
+            type: string;
+            prop: string;
+            cssProperty: string;
+            responsive: boolean;
+            values?: string[] | undefined;
+        }[];
+    }[];
+}>;
+export declare const OverviewDataSchema: z.ZodObject<{
+    description: z.ZodString;
+    architecture: z.ZodString;
+    packages: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        npmName: z.ZodString;
+        description: z.ZodString;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        name: string;
+        npmName: string;
+        version: string;
+    }, {
+        description: string;
+        name: string;
+        npmName: string;
+        version: string;
+    }>, "many">;
+    breakpoints: z.ZodRecord<z.ZodString, z.ZodString>;
+    installation: z.ZodString;
+    cssLayers: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    architecture: string;
+    packages: {
+        description: string;
+        name: string;
+        npmName: string;
+        version: string;
+    }[];
+    breakpoints: Record<string, string>;
+    installation: string;
+    cssLayers: string;
+}, {
+    description: string;
+    architecture: string;
+    packages: {
+        description: string;
+        name: string;
+        npmName: string;
+        version: string;
+    }[];
+    breakpoints: Record<string, string>;
+    installation: string;
+    cssLayers: string;
+}>;

package/dist/lib/schemas.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export const DocsEntrySchema = z.object({
+    sourcePath: z.string(),
+    title: z.string(),
+    description: z.string(),
+    category: z.string(),
+    headings: z.array(z.string()),
+    keywords: z.array(z.string()),
+    snippet: z.string(),
+});
+const ComponentPropSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    default: z.string().optional(),
+    description: z.string(),
+});
+export const ComponentInfoSchema = z.object({
+    name: z.string(),
+    package: z.enum(['lism-css', '@lism-css/ui']),
+    category: z.string(),
+    description: z.string(),
+    props: z.array(ComponentPropSchema),
+    usage: z.string(),
+});
+const TokenEntrySchema = z.object({
+    name: z.string(),
+    value: z.string(),
+    description: z.string().optional(),
+});
+export const TokenCategorySchema = z.object({
+    category: z.string(),
+    description: z.string(),
+    tokens: z.array(TokenEntrySchema),
+});
+const PropEntrySchema = z.object({
+    prop: z.string(),
+    cssProperty: z.string(),
+    type: z.string(),
+    responsive: z.boolean(),
+    description: z.string(),
+    values: z.array(z.string()).optional(),
+});
+const PropCategorySchema = z.object({
+    category: z.string(),
+    description: z.string(),
+    props: z.array(PropEntrySchema),
+});
+export const PropsSystemDataSchema = z.object({
+    description: z.string(),
+    categories: z.array(PropCategorySchema),
+});
+const PackageInfoSchema = z.object({
+    name: z.string(),
+    npmName: z.string(),
+    description: z.string(),
+    version: z.string(),
+});
+export const OverviewDataSchema = z.object({
+    description: z.string(),
+    architecture: z.string(),
+    packages: z.array(PackageInfoSchema),
+    breakpoints: z.record(z.string()),
+    installation: z.string(),
+    cssLayers: z.string(),
+});

package/dist/lib/search.d.ts

@@ -0,0 +1,2 @@
+import type { DocsEntry, SearchResult } from './types.js';
+export declare function searchDocs(entries: DocsEntry[], query: string, category?: string, limit?: number): SearchResult[];

package/dist/lib/search.js

@@ -0,0 +1,57 @@
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[\s\-_./]+/)
+        .filter((t) => t.length > 0);
+}
+function scoreEntry(entry, queryTokens) {
+    let score = 0;
+    const titleLower = entry.title.toLowerCase();
+    const descLower = entry.description.toLowerCase();
+    const headingsLower = entry.headings.join(' ').toLowerCase();
+    const keywordsLower = entry.keywords.join(' ').toLowerCase();
+    const snippetLower = entry.snippet.toLowerCase();
+    for (const token of queryTokens) {
+        // title matches are weighted highest
+        if (titleLower.includes(token))
+            score += 10;
+        // keywords
+        if (keywordsLower.includes(token))
+            score += 5;
+        // headings
+        if (headingsLower.includes(token))
+            score += 3;
+        // description
+        if (descLower.includes(token))
+            score += 2;
+        // snippet
+        if (snippetLower.includes(token))
+            score += 1;
+    }
+    return score;
+}
+export function searchDocs(entries, query, category, limit = 10) {
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0)
+        return [];
+    let filtered = entries;
+    if (category && category !== 'all') {
+        filtered = entries.filter((e) => e.category === category);
+    }
+    const scored = filtered
+        .map((entry) => {
+        const score = scoreEntry(entry, queryTokens);
+        return { entry, score };
+    })
+        .filter(({ score }) => score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    const DOCS_BASE_URL = 'https://lism-css.com/ja/docs';
+    return scored.map(({ entry, score }) => ({
+        sourcePath: entry.sourcePath,
+        url: `${DOCS_BASE_URL}/${entry.sourcePath.replace(/\.mdx$/, '')}/`,
+        heading: entry.title,
+        snippet: entry.snippet,
+        score,
+    }));
+}

package/dist/lib/types.d.ts

@@ -0,0 +1,76 @@
+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;
+}
+export interface ComponentInfo {
+    name: string;
+    package: 'lism-css' | '@lism-css/ui';
+    category: string;
+    description: string;
+    props: ComponentProp[];
+    usage: string;
+}
+export interface ComponentProp {
+    name: string;
+    type: string;
+    default?: string;
+    description: string;
+}
+export interface TokenCategory {
+    category: string;
+    description: string;
+    tokens: TokenEntry[];
+}
+export interface TokenEntry {
+    name: string;
+    value: string;
+    description?: string;
+}
+export interface PropEntry {
+    prop: string;
+    cssProperty: string;
+    type: string;
+    responsive: boolean;
+    description: string;
+    values?: string[];
+}
+export interface PropsSystemData {
+    description: string;
+    categories: PropCategory[];
+}
+export interface PropCategory {
+    category: string;
+    description: string;
+    props: PropEntry[];
+}
+export interface OverviewData {
+    description: string;
+    architecture: string;
+    packages: PackageInfo[];
+    breakpoints: Record<string, string>;
+    installation: string;
+    cssLayers: string;
+}
+export interface PackageInfo {
+    name: string;
+    npmName: string;
+    description: string;
+    version: string;
+}

package/dist/lib/types.js

@@ -0,0 +1 @@
+export {};

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

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