reicon-mcp 1.0.0

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "reicon-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "MCP server and CLI for browsing and applying Reicon icons.",
+  "bin": {
+    "reicon-mcp": "bin/run.cjs"
+  },
+  "main": "./server/index.js",
+  "files": [
+    "bin",
+    "cli",
+    "server",
+    "core",
+    "data",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build.cjs"
+  },
+  "keywords": [
+    "reicon",
+    "icons",
+    "mcp",
+    "model-context-protocol",
+    "svg"
+  ],
+  "author": "Dev Chauhan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dqev/reicon.git",
+    "directory": "packages/reicon-mcp"
+  },
+  "homepage": "https://reicon.dev",
+  "bugs": {
+    "url": "https://github.com/dqev/reicon/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/server/index.d.ts

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

package/server/index.js

@@ -0,0 +1,57 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { handleApplyIcon } from './tools/apply-icon.js';
+import { handleListCategories } from './tools/list-categories.js';
+import { handleSearchIcons } from './tools/search-icons.js';
+import { handleViewIcon } from './tools/view-icon.js';
+const server = new McpServer({
+    name: 'reicon-mcp',
+    version: '1.0.0',
+});
+server.tool('search_icons', 'Search Reicon icons by keyword. Returns ranked matches for agent selection.', {
+    query: z.string().describe('Concise search keywords, not full sentences'),
+    weight: z.enum(['Outline', 'Filled']).optional(),
+    limit: z.number().optional(),
+}, async (args) => {
+    const result = handleSearchIcons(args);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool('view_icon', 'View raw SVG markup and metadata for a Reicon icon.', {
+    name: z.string().describe('Icon kebab-case name'),
+    weight: z.enum(['Outline', 'Filled']),
+}, async (args) => {
+    const result = handleViewIcon(args);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool('apply_icon', 'Generate copy-pasteable import and usage code for a Reicon icon.', {
+    name: z.string(),
+    weight: z.enum(['Outline', 'Filled']),
+    framework: z.enum(['react', 'vue', 'svelte', 'html', 'svg']),
+    size: z.number().optional(),
+    color: z.string().optional(),
+    componentName: z.string().optional(),
+}, async (args) => {
+    const result = handleApplyIcon(args);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+});
+server.tool('list_categories', 'List all icon categories in the Reicon dataset.', {}, async () => {
+    const result = handleListCategories();
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/server/tools/apply-icon.d.ts

@@ -0,0 +1,4 @@
+import type { ApplyIconInput } from '../../core/types.js';
+export declare function handleApplyIcon(args: ApplyIconInput): import("../../core/types.js").ApplyIconOutput | {
+    error: string;
+};

package/server/tools/apply-icon.js

@@ -0,0 +1,11 @@
+import { generateCode } from '../../core/codegen.js';
+import { loadIndex } from '../../core/load-index.js';
+import { findIcon } from '../../core/search.js';
+export function handleApplyIcon(args) {
+    const index = loadIndex();
+    const icon = findIcon(index, args.name);
+    if (!icon) {
+        return { error: `Icon "${args.name}" not found.` };
+    }
+    return generateCode(icon, args);
+}

package/server/tools/list-categories.d.ts

@@ -0,0 +1,3 @@
+export declare function handleListCategories(): {
+    categories: string[];
+};

package/server/tools/list-categories.js

@@ -0,0 +1,6 @@
+import { loadIndex } from '../../core/load-index.js';
+import { listCategories } from '../../core/search.js';
+export function handleListCategories() {
+    const index = loadIndex();
+    return { categories: listCategories(index) };
+}

package/server/tools/search-icons.d.ts

@@ -0,0 +1,11 @@
+import type { IconWeight } from '../../core/types.js';
+export declare function handleSearchIcons(args: {
+    query: string;
+    weight?: IconWeight;
+    limit?: number;
+}): {
+    results: import("../../core/types.js").SearchResult[];
+    instruction: string;
+} | {
+    error: string;
+};

package/server/tools/search-icons.js

@@ -0,0 +1,9 @@
+import { loadIndex } from '../../core/load-index.js';
+import { searchIcons } from '../../core/search.js';
+export function handleSearchIcons(args) {
+    const index = loadIndex();
+    return searchIcons(index, args.query, {
+        weight: args.weight,
+        limit: args.limit,
+    });
+}

package/server/tools/view-icon.d.ts

@@ -0,0 +1,12 @@
+import type { IconWeight } from '../../core/types.js';
+export declare function handleViewIcon(args: {
+    name: string;
+    weight: IconWeight;
+}): {
+    error: string;
+} | {
+    svg: string;
+    viewBox: string;
+    tags: string[];
+    category: string;
+};

package/server/tools/view-icon.js

@@ -0,0 +1,21 @@
+import { buildSvgMarkup } from '../../core/codegen.js';
+import { loadIndex } from '../../core/load-index.js';
+import { findIcon } from '../../core/search.js';
+export function handleViewIcon(args) {
+    const index = loadIndex();
+    const icon = findIcon(index, args.name);
+    if (!icon) {
+        return { error: `Icon "${args.name}" not found.` };
+    }
+    const svg = buildSvgMarkup(icon, args.weight);
+    if (typeof svg !== 'string') {
+        return svg;
+    }
+    const weightData = icon.weights[args.weight];
+    return {
+        svg,
+        viewBox: weightData.viewBox,
+        tags: icon.tags,
+        category: icon.category,
+    };
+}