mozaic-mcp-server 1.0.0

package/dist/tools/search-icons.js

@@ -0,0 +1,134 @@
+import { listIconTypes, searchIcons } from "../db/queries.js";
+export function handleSearchIcons(db, input) {
+    const { query, type, size, limit = 20 } = input;
+    if (!query || query.trim().length === 0) {
+        // If no query, list available icon types
+        const types = listIconTypes(db);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        message: "Please provide a search query. Here are the available icon types:",
+                        types: types.map((t) => `${t.type} (${t.count} icons)`),
+                        example: 'search_icons({ query: "arrow", type: "navigation" })',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // Build FTS query with prefix matching
+    const searchStrategies = buildSearchStrategies(query);
+    // Try each strategy until we find results
+    for (const ftsQuery of searchStrategies) {
+        try {
+            const results = searchIcons(db, ftsQuery, { type, size, limit });
+            if (results.length > 0) {
+                return formatResults(results, query, type, size);
+            }
+        }
+        catch {
+            // FTS5 syntax error - try next strategy
+            continue;
+        }
+    }
+    // No results found
+    const types = listIconTypes(db);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    query,
+                    resultCount: 0,
+                    message: `No icons found for "${query}". Try a different search term.`,
+                    availableTypes: types.map((t) => t.type),
+                }, null, 2),
+            },
+        ],
+    };
+}
+// Build multiple FTS5 search strategies from strict to fuzzy
+function buildSearchStrategies(query) {
+    // Clean query - remove special characters, normalize spaces
+    const cleaned = query.replace(/[^\w\s]/g, " ");
+    const terms = cleaned
+        .trim()
+        .split(/\s+/)
+        .filter((term) => term.length > 1);
+    if (terms.length === 0) {
+        return [`${query.trim()}*`];
+    }
+    if (terms.length === 1) {
+        return [`${terms[0]}*`];
+    }
+    // Multiple terms: try AND then OR
+    return [terms.map((t) => `${t}*`).join(" AND "), terms.map((t) => `${t}*`).join(" OR ")];
+}
+function formatResults(results, query, type, size) {
+    // Group by icon name to show available sizes
+    const grouped = new Map();
+    for (const icon of results) {
+        const key = icon.iconName;
+        if (!grouped.has(key)) {
+            grouped.set(key, {
+                iconName: icon.iconName,
+                type: icon.type,
+                sizes: [],
+            });
+        }
+        grouped.get(key)?.sizes.push(icon.size);
+    }
+    const output = {
+        query,
+        filters: { type: type || "all", size: size || "all" },
+        resultCount: results.length,
+        uniqueIcons: grouped.size,
+        icons: Array.from(grouped.values()).map((g) => ({
+            name: g.iconName,
+            type: g.type,
+            availableSizes: g.sizes.sort((a, b) => a - b),
+            usage: {
+                react: `import { ${g.iconName}${g.sizes[0]} } from "@mozaic-ds/icons/js/icons"`,
+                vue: `<MIcon name="${g.iconName}${g.sizes[0]}" />`,
+            },
+        })),
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+    };
+}
+// Tool definition for MCP
+export const searchIconsTool = {
+    name: "search_icons",
+    description: "Search Mozaic Design System icons by name, type (navigation, media, social, etc.), or size (16, 24, 32, 48, 64)",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: 'Search query for icon name (e.g., "arrow", "cart", "user", "check")',
+            },
+            type: {
+                type: "string",
+                description: 'Filter by icon type/category (e.g., "navigation", "media", "social", "payment")',
+            },
+            size: {
+                type: "number",
+                description: "Filter by icon size in pixels (16, 24, 32, 48, or 64)",
+            },
+            limit: {
+                type: "number",
+                default: 20,
+                description: "Maximum number of results to return",
+            },
+        },
+        required: ["query"],
+    },
+};
+//# sourceMappingURL=search-icons.js.map

package/dist/tools/search-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-icons.js","sourceRoot":"","sources":["../../src/tools/search-icons.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "mozaic-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Mozaic Design System by ADEO",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mozaic-mcp-server": "dist/index.js",
+    "mozaic-skills": "bin/install-skills.js"
+  },
+  "files": [
+    "dist",
+    "data",
+    "skills",
+    "bin",
+    "README.md",
+    "SKILLS.md",
+    "INSTALLATION.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "compile": "tsc",
+    "build": "tsc && tsx scripts/build-index.ts",
+    "build:docs": "tsx scripts/generate-docs.ts",
+    "rebuild": "pnpm rebuild better-sqlite3",
+    "start": "node dist/index.js",
+    "start:debug": "node dist/index.js --debug",
+    "dev": "tsx watch src/index.ts",
+    "clean": "rm -rf dist data/mozaic.db",
+    "database:sanity": "tsx scripts/sanity-check.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src scripts",
+    "lint:fix": "eslint src scripts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"scripts/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"scripts/**/*.ts\"",
+    "prepare": "husky",
+    "prebuild": "rm -rf dist",
+    "install-mcp": "./scripts/install.sh",
+    "uninstall-mcp": "./scripts/uninstall.sh",
+    "install-skills": "./scripts/install-skills.sh",
+    "uninstall-skills": "./scripts/uninstall-skills.sh"
+  },
+  "keywords": [
+    "mcp",
+    "mozaic",
+    "design-system",
+    "adeo",
+    "claude"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MerzoukeMansouri/adeo-mozaic-mcp.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "11.10.0",
+    "glob": "^10.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^10.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.3.0",
+    "prettier": "^3.4.2",
+    "puppeteer": "^24.33.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.18.1",
+    "vitest": "^4.0.15"
+  },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "engines": {
+    "node": ">=25.0.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3"
+    ]
+  }
+}