@nodo-icons/mcp 0.0.0-stage → 0.1.0

package/data/shadcn-map.json

@@ -0,0 +1 @@
+{"ChevronRightIcon":"ChevronRightIcon","CheckIcon":"CheckIcon","ChevronDownIcon":"ChevronDownIcon","SearchIcon":"SearchIcon","MoreHorizontalIcon":"MoreHorizontalIcon","GalleryVerticalEndIcon":"LayersIcon","PlusIcon":"PlusIcon","BellIcon":"BellIcon","CopyIcon":"CopyIcon","FolderIcon":"FolderIcon","ChevronsUpDownIcon":"ChevronUpDownIcon","CreditCardIcon":"CreditCardIcon","LogOutIcon":"LogOutIcon","FileIcon":"FileIcon","ArrowRightIcon":"ArrowRightIcon","Trash2Icon":"TrashIcon","TrashIcon":"TrashIcon","FileTextIcon":"FileTextIcon","SparklesIcon":"SparklesIcon","Settings2Icon":"SlidersHorizontalIcon","TerminalIcon":"TerminalIcon","ShareIcon":"ShareIcon","SettingsIcon":"SettingsIcon","BadgeCheckIcon":"BadgeCheckIcon","ArrowUpRightIcon":"ArrowUpRightIcon","HomeIcon":"HomeIcon","XIcon":"CloseIcon","InfoIcon":"InfoIcon","UserIcon":"UserIcon","InboxIcon":"InboxIcon","ArrowUpIcon":"ArrowUpIcon","LinkIcon":"LinkIcon","ChevronLeftIcon":"ChevronLeftIcon","MinusIcon":"MinusIcon","Loader2Icon":"LoaderCircleIcon","ArrowDownIcon":"ArrowDownIcon","AudioLinesIcon":"WaveformIcon","CalendarIcon":"CalendarIcon","ScissorsIcon":"ScissorsIcon","ClipboardPasteIcon":"PasteIcon","MailIcon":"MailIcon","SaveIcon":"SaveIcon","TerminalSquareIcon":"TerminalIcon","BotIcon":"RobotIcon","FrameIcon":"ArtboardIcon","PieChartIcon":"ChartPieIcon","MapIcon":"MapIcon","DownloadIcon":"DownloadIcon","BookOpenIcon":"BookOpenIcon","ChevronUpIcon":"ChevronUpIcon","PanelLeftIcon":"SidebarLeftIcon","CircleCheckIcon":"CheckCircleIcon","CircleAlertIcon":"AlertCircleIcon","ArrowLeftIcon":"ArrowLeftIcon","TrendingUpIcon":"TrendingUpIcon","HelpCircleIcon":"HelpIcon","CodeIcon":"CodeIcon","CircleDashedIcon":"CircleDashedIcon","GlobeIcon":"GlobeIcon","RefreshCwIcon":"RefreshIcon","BoldIcon":"BoldIcon","ItalicIcon":"ItalicIcon","UnderlineIcon":"UnderlineIcon","ChartLineIcon":"ChartLineIcon","StarIcon":"StarIcon","FileCodeIcon":"FileCodeIcon","FileSearchIcon":"FileSearchIcon","SendIcon":"SendIcon","TriangleAlertIcon":"AlertTriangleIcon","OctagonXIcon":"CloseOctagonIcon","BluetoothIcon":"BluetoothIcon","HeartIcon":"HeartIcon","ListIcon":"ListBulletIcon","ImageIcon":"ImageIcon","PencilIcon":"EditIcon","ArchiveIcon":"ArchiveIcon","LayoutIcon":"LayoutIcon","UsersIcon":"UsersIcon","TableIcon":"TableIcon","ChartBarIcon":"ChartBarIcon","ShoppingBagIcon":"ShoppingBagIcon","ThumbsUpIcon":"ThumbsUpIcon","ThumbsDownIcon":"ThumbsDownIcon","SunIcon":"SunIcon","KeyboardIcon":"KeyboardIcon","FileArchiveIcon":"FileZipIcon","PresentationIcon":"PresentationIcon","ClockIcon":"ClockIcon","BookmarkIcon":"BookmarkIcon","LifeBuoyIcon":"LifebuoyIcon","BlocksIcon":"BlocksIcon","MessageCircleQuestionIcon":"ChatQuestionIcon","StarOffIcon":"StarOffIcon","ArrowLeftCircleIcon":"ArrowCircleLeftIcon","BadgeCheck":"BadgeCheckIcon","VolumeX":"VolumeMuteIcon","AlertTriangleIcon":"AlertTriangleIcon","UserRoundXIcon":"UserXIcon","FlipHorizontalIcon":"FlipHorizontalIcon","FlipVerticalIcon":"FlipVerticalIcon","RotateCwIcon":"RotateCwIcon","Clock2Icon":"ClockIcon","CaptionsIcon":"ClosedCaptionsIcon","MinimizeIcon":"MinusIcon","MaximizeIcon":"PlusIcon","SmileIcon":"SmileIcon","CalculatorIcon":"CalculatorIcon","FolderPlusIcon":"FolderPlusIcon","LayoutGridIcon":"ViewGridIcon","ZoomInIcon":"ZoomInIcon","ZoomOutIcon":"ZoomOutIcon","ActivityIcon":"PulseIcon","MessageSquareIcon":"ChatSquareIcon","WalletIcon":"WalletIcon","Building2Icon":"OfficeIcon","PlusCircleIcon":"PlusCircleIcon","ChartPieIcon":"ChartPieIcon","EyeOffIcon":"EyeOffIcon","MicIcon":"MicrophoneIcon","RadioIcon":"RadioIcon","ExternalLinkIcon":"ExternalLinkIcon","ShoppingCartIcon":"CartIcon","LifeBuoy":"LifebuoyIcon","Send":"SendIcon","AppWindowIcon":"WindowIcon","BookOpen":"BookOpenIcon","StopCircleIcon":"StopCircleIcon","MoreVerticalIcon":"MoreVerticalIcon","FolderOpenIcon":"FolderOpenIcon","FolderSearchIcon":"FolderSearchIcon","EyeIcon":"EyeIcon","PaletteIcon":"PaletteIcon","MoonIcon":"MoonIcon","MonitorIcon":"MonitorIcon","LanguagesIcon":"TranslateIcon","ShieldIcon":"ShieldIcon","FileWarningIcon":"FileWarningIcon","GitBranchIcon":"GitBranchIcon","CircleUserIcon":"UserCircleIcon","RefreshCcwIcon":"RefreshCcwIcon","WrapTextIcon":"TextWrapIcon","BrainIcon":"BrainIcon","LayoutDashboardIcon":"LayoutDashboardIcon","CameraIcon":"CameraIcon","CircleHelpIcon":"HelpIcon","DatabaseIcon":"DatabaseIcon","FileChartColumnIcon":"FileChartIcon","CommandIcon":"CommandIcon","GripVerticalIcon":"GripVerticalIcon","LoaderIcon":"LoaderIcon","EllipsisVerticalIcon":"MoreVerticalIcon","Columns3Icon":"LayoutColumnsThreeIcon","ChevronsLeftIcon":"ChevronDoubleLeftIcon","ChevronsRightIcon":"ChevronDoubleRightIcon","CirclePlusIcon":"PlusCircleIcon","CircleUserRoundIcon":"UserCircleIcon","TrendingDownIcon":"TrendingDownIcon","ArchiveXIcon":"ArchiveXIcon","CornerUpRightIcon":"CornerUpRightIcon","CornerUpLeftIcon":"CornerUpLeftIcon","MenuIcon":"MenuIcon","PaintbrushIcon":"PaintbrushIcon","MessageCircleIcon":"ChatIcon","VideoIcon":"VideoIcon","LockIcon":"LockIcon","VolumeOffIcon":"VolumeMuteIcon"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@nodo-icons/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "author": "Nodo Icons <hello@nodoicons.com> (https://nodoicons.com)",
+  "bugs": {
+    "email": "support@nodoicons.com",
+    "url": "https://nodoicons.com/docs/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NodoIcons/nodoicons.git"
+  },
+  "version": "0.1.0",
+  "description": "MCP server and CLI for Nodo Icons: let AI agents search 5,000 icons and insert SVG, React or Vue code.",
+  "mcpName": "io.github.NodoIcons/nodo-icons",
+  "homepage": "https://nodoicons.com/docs/",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "nodo-icons": "src/cli.js"
+  },
+  "files": [
+    "src/",
+    "data/",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "icons",
+    "icon-set",
+    "icon-library",
+    "svg",
+    "ui",
+    "ui-icons",
+    "nodo-icons",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "cli"
+  ]
+}

package/src/cli.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+// nodo-icons — no arguments: start the MCP server (stdio). With a command: a small CLI.
+//   nodo-icons search <words> [--limit 20] [--category name]
+//   nodo-icons get <name> [--style linear] [--format svg|react|vue|sprite] [--size 24] [--color #000]
+//   nodo-icons migrate-lucide [dir] [--dry]   switch lucide-react imports to @nodo-icons/react
+//   nodo-icons styles | categories
+import { search, getIcon, styles, categories } from './core.js';
+
+const [cmd, ...rest] = process.argv.slice(2);
+const flags = {}, words = [];
+for (let i = 0; i < rest.length; i++) {
+  if (rest[i].startsWith('--')) flags[rest[i].slice(2)] = rest[i + 1]?.startsWith('--') || rest[i + 1] === undefined ? true : rest[++i];
+  else words.push(rest[i]);
+}
+const num = (v) => (v === undefined ? undefined : Number(v));
+
+if (!cmd || cmd === 'mcp') {
+  const { startServer } = await import('./server.js');
+  startServer();
+} else if (cmd === 'search') {
+  const res = search(words.join(' '), { limit: num(flags.limit) || 20, category: flags.category });
+  console.log(res.length ? res.map((i) => `${i.name.padEnd(28)} ${i.category}`).join('\n') : 'No match.');
+} else if (cmd === 'get') {
+  const r = getIcon(words[0] || '', { style: flags.style, format: flags.format, size: num(flags.size), color: flags.color, strokeWidth: num(flags['stroke-width']) });
+  (r.ok ? console.log : console.error)(r.text);
+  process.exitCode = r.ok ? 0 : 1;
+} else if (cmd === 'migrate-lucide') {
+  const { migrateDir } = await import('./migrate.js');
+  const r = migrateDir(words[0] || '.', { dry: Boolean(flags.dry) });
+  console.log(`✓ ${r.swapped} icon import(s) in ${r.files} file(s) switched to @nodo-icons/react${flags.dry ? ' (dry run, nothing written)' : ''}.`);
+  if (r.kept.size) console.log(`Kept on lucide-react (no Nodo equivalent yet): ${[...r.kept].join(', ')}`);
+  if (r.swapped && !flags.dry) console.log('Next: npm install @nodo-icons/react');
+} else if (cmd === 'styles') {
+  for (const s of styles()) console.log(`${s.style.padEnd(10)} ${s.tier}`);
+} else if (cmd === 'categories') {
+  for (const c of categories()) console.log(`${c.category.padEnd(16)} ${c.count}`);
+} else {
+  console.log('Usage: nodo-icons [mcp] | search <words> | get <name> [--style s] [--format svg|react|vue|sprite] | migrate-lucide [dir] [--dry] | styles | categories');
+}

package/src/core.js

@@ -0,0 +1,117 @@
+// Icon catalogue for agents: search, metadata and code snippets. No dependencies.
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { STYLE_INFO, STYLES, toSVG, componentName } from './render.js';
+
+const DATA = JSON.parse(readFileSync(new URL('../data/icons.json', import.meta.url), 'utf8'));
+export const FREE_STYLE = DATA.free;
+export const VERSION = DATA.version;
+export const PRO_URL = 'https://nodoicons.com/#pricing';
+const PRO_DIR = process.env.NODO_PRO_DIR || ''; // folder of the unzipped Pro download (contains svg/<style>/)
+
+export const icons = DATA.icons.map(([name, category, tags]) => ({ name, category, tags }));
+const byName = new Map(icons.map((i) => [i.name, i]));
+
+export const isFree = (style) => style === FREE_STYLE;
+export const proAvailable = () => Boolean(PRO_DIR) && existsSync(join(PRO_DIR, 'svg'));
+
+export function styles() {
+  return STYLES.map((s) => ({
+    style: s,
+    label: STYLE_INFO[s].label,
+    tier: isFree(s) ? 'free (MIT)' : 'pro',
+    paint: STYLE_INFO[s].paint,
+    ...(STYLE_INFO[s].strokeWidth ? { strokeWidth: STYLE_INFO[s].strokeWidth } : {}),
+  }));
+}
+
+export function categories() {
+  const c = new Map();
+  for (const i of icons) c.set(i.category, (c.get(i.category) || 0) + 1);
+  return [...c].sort((a, b) => b[1] - a[1]).map(([category, count]) => ({ category, count }));
+}
+
+/** Ranked search over names, tags and categories; every word of the query must match something. */
+export function search(query, { category, limit = 20 } = {}) {
+  const words = String(query || '').toLowerCase().split(/[\s,]+/).filter(Boolean);
+  const out = [];
+  for (const i of icons) {
+    if (category && i.category !== category) continue;
+    let score = 0, ok = true;
+    for (const w of words) {
+      let s = 0;
+      if (i.name === w) s = 100;
+      else if (i.name.split('-').includes(w)) s = 70;
+      else if (i.name.startsWith(w)) s = 60;
+      else if (i.name.includes(w)) s = 40;
+      if (i.tags.includes(w)) s = Math.max(s, 35);
+      else if (i.tags.some((t) => t.startsWith(w))) s = Math.max(s, 18);
+      if (i.category === w) s = Math.max(s, 12);
+      if (!s) { ok = false; break; }
+      score += s;
+    }
+    if (ok) out.push({ ...i, score: score - i.name.length * 0.1 });
+  }
+  if (!words.length) return icons.slice(0, limit);
+  return out.sort((a, b) => b.score - a.score).slice(0, limit).map(({ score, ...i }) => i);
+}
+
+export function suggest(name) {
+  return search(name.replace(/-/g, ' '), { limit: 5 }).map((i) => i.name);
+}
+
+function svgFor(name, style, opts) {
+  if (isFree(style)) {
+    return toSVG({ styles: { [style]: { nodes: DATA.linear[name] } } }, style, opts);
+  }
+  if (!proAvailable()) return null;
+  const file = join(PRO_DIR, 'svg', style, `${name}.svg`);
+  if (!existsSync(file)) return null;
+  let svg = readFileSync(file, 'utf8').trim();
+  if (opts.size) svg = svg.replace(/width="[^"]*"/, `width="${opts.size}"`).replace(/height="[^"]*"/, `height="${opts.size}"`);
+  if (opts.color && opts.color !== 'currentColor') svg = svg.replaceAll('currentColor', opts.color);
+  return svg;
+}
+
+/**
+ * Code for one icon. format: svg | react | vue | sprite.
+ * Returns { ok, text } — text is ready to paste, with a one-line note when Pro is involved.
+ */
+export function getIcon(name, { style = FREE_STYLE, format = 'svg', size = 24, color = 'currentColor', strokeWidth } = {}) {
+  const icon = byName.get(name);
+  if (!icon) {
+    const alt = suggest(name);
+    return { ok: false, text: `No icon named "${name}".${alt.length ? ` Closest: ${alt.join(', ')}.` : ''}` };
+  }
+  if (!STYLE_INFO[style]) return { ok: false, text: `Unknown style "${style}". Styles: ${STYLES.join(', ')}.` };
+  const comp = componentName(name);
+  const pro = !isFree(style);
+  const pkg = (fw) => `@nodo-icons/${fw}`;
+  const sw = strokeWidth && STYLE_INFO[style].paint === 'stroke' ? strokeWidth : undefined;
+
+  // Pro styles have no React/Vue package yet: hand back their SVG from the Pro download instead.
+  if (pro && (format === 'react' || format === 'vue')) {
+    const soon = `React/Vue packages for Nodo Icons Pro styles are not released yet; the free Linear style is "@nodo-icons/${format}".`;
+    const svg = svgFor(name, style, { size, color, strokeWidth: sw });
+    if (svg) return { ok: true, text: `${svg}\n\n<!-- ${STYLE_INFO[style].label} SVG from your Pro download. ${soon} -->` };
+    return { ok: false, text: `"${name}" in ${STYLE_INFO[style].label} is a Nodo Icons Pro style. With a Pro license, set NODO_PRO_DIR to the unzipped Pro download to get its SVG (${PRO_URL}). ${soon}` };
+  }
+
+  if (format === 'react') {
+    const props = [`size={${size}}`, color !== 'currentColor' ? `color="${color}"` : '', sw ? `strokeWidth={${sw}}` : ''].filter(Boolean).join(' ');
+    return { ok: true, text: `import { ${comp} } from '${pkg('react')}';\n\n<${comp} ${props} />` };
+  }
+  if (format === 'vue') {
+    const props = [`:size="${size}"`, color !== 'currentColor' ? `color="${color}"` : '', sw ? `:stroke-width="${sw}"` : ''].filter(Boolean).join(' ');
+    return { ok: true, text: `<script setup>\nimport { ${comp} } from '${pkg('vue')}';\n</script>\n\n<template><${comp} ${props} /></template>` };
+  }
+  if (format === 'sprite') {
+    const htmlNote = pro ? `\n<!-- ${STYLE_INFO[style].label} is a Nodo Icons Pro style: it needs a Pro license (${PRO_URL}). -->` : '';
+    return { ok: true, text: `<svg width="${size}" height="${size}" aria-hidden="true"><use href="sprite/${style}.svg#nd-${name}"/></svg>${htmlNote}` };
+  }
+  const svg = svgFor(name, style, { size, color, strokeWidth: sw });
+  if (!svg) {
+    return { ok: false, text: `"${name}" in ${STYLE_INFO[style].label} is a Nodo Icons Pro style. With a Pro license, set NODO_PRO_DIR to the unzipped Pro download to get its SVG here (${PRO_URL}). The free Linear SVG is available now: use style "${FREE_STYLE}".` };
+  }
+  return { ok: true, text: svg };
+}

package/src/migrate.js

@@ -0,0 +1,67 @@
+// Codemod: switch a project's lucide-react imports to @nodo-icons/react, keeping local names,
+// so JSX does not change:  import { ChevronRight } from "lucide-react"
+//                       →  import { ChevronRightIcon as ChevronRight } from "@nodo-icons/react"
+// Icons without a Nodo equivalent stay on lucide-react and are reported.
+import { readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import { icons } from './core.js';
+import { componentName } from './render.js';
+
+const SHADCN = JSON.parse(readFileSync(new URL('../data/shadcn-map.json', import.meta.url), 'utf8'));
+const NAMES = new Set(icons.map((i) => i.name));
+const kebab = (s) => s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/([A-Z])([A-Z][a-z])/g, '$1-$2').toLowerCase();
+
+/** lucide export name (ChevronRight, ChevronRightIcon, LucideChevronRight) → Nodo component or null */
+export function nodoFor(lucideName) {
+  const base = lucideName.replace(/^Lucide/, '').replace(/Icon$/, '');
+  const viaShadcn = SHADCN[`${base}Icon`];
+  if (viaShadcn) return viaShadcn;
+  const k = kebab(base);
+  return NAMES.has(k) ? componentName(k) : null;
+}
+
+export function migrateSource(src) {
+  const kept = [], done = [];
+  const out = src.replace(/import\s*(type\s+)?\{([^}]*)\}\s*from\s*(['"])lucide-react\3[ \t]*;?/g, (stmt, typeOnly, list, q) => {
+    if (typeOnly) return stmt;
+    const specs = list.split(',').map((s) => s.trim()).filter(Boolean);
+    const nodo = [], lucide = [];
+    for (const spec of specs) {
+      const [imported, local = imported] = spec.split(/\s+as\s+/).map((s) => s.trim());
+      const comp = /^(type\s|LucideIcon$|LucideProps$|icons$|createLucideIcon$)/.test(imported) ? null : nodoFor(imported);
+      if (comp) { nodo.push(comp === local ? comp : `${comp} as ${local}`); done.push(`${imported}→${comp}`); }
+      else { lucide.push(spec); if (!/^type\s/.test(imported)) kept.push(imported); }
+    }
+    const semi = stmt.trim().endsWith(';') ? ';' : '';
+    return [
+      nodo.length ? `import { ${nodo.join(', ')} } from ${q}@nodo-icons/react${q}${semi}` : '',
+      lucide.length ? `import { ${lucide.join(', ')} } from ${q}lucide-react${q}${semi}` : '',
+    ].filter(Boolean).join('\n');
+  });
+  return { out, done, kept };
+}
+
+function* walk(dir) {
+  for (const f of readdirSync(dir)) {
+    if (f === 'node_modules' || f.startsWith('.') || f === 'dist' || f === 'build') continue;
+    const p = join(dir, f);
+    if (statSync(p).isDirectory()) yield* walk(p);
+    else if (['.tsx', '.jsx', '.ts', '.js', '.mdx'].includes(extname(p))) yield p;
+  }
+}
+
+export function migrateDir(dir, { dry = false } = {}) {
+  const report = { files: 0, swapped: 0, kept: new Set() };
+  for (const f of walk(dir)) {
+    const src = readFileSync(f, 'utf8');
+    if (!src.includes('lucide-react')) continue;
+    const { out, done, kept } = migrateSource(src);
+    kept.forEach((k) => report.kept.add(k));
+    if (out !== src) {
+      report.files++; report.swapped += done.length;
+      console.log(`${dry ? '[dry] ' : ''}${f}: ${done.length} icon(s)${kept.length ? `, ${kept.length} kept on lucide-react` : ''}`);
+      if (!dry) writeFileSync(f, out);
+    }
+  }
+  return report;
+}

package/src/render.js

@@ -0,0 +1,66 @@
+// Turns compiled icon data (src/generated/icons.json) into SVG markup.
+// Shared by the build scripts and the preview site, so it stays dependency-free.
+
+// The one style table. Everything (SVG, sprite, React, Vue, fonts, site, verify) reads from here.
+//   paint   'stroke' → root draws strokes; 'fill' → root draws fills
+//   layers  true when the icon font needs a second (secondary) glyph layer, drawn at layerOpacity
+export const STYLE_INFO = {
+  linear: { label: 'Linear', paint: 'stroke', strokeWidth: 1.5, blurb: 'Contorno 1.5px, terminali arrotondati. Neutro e leggero.' },
+  light: { label: 'Light', paint: 'stroke', strokeWidth: 1, blurb: 'Contorno 1px: elegante, per dimensioni grandi e UI ariose.' },
+  bold: { label: 'Bold', paint: 'stroke', strokeWidth: 2, blurb: 'Contorno 2px: più presenza a 16–20px e su sfondi rumorosi.' },
+  sharp: { label: 'Sharp', paint: 'stroke', strokeWidth: 1.5, cap: 'butt', join: 'miter', blurb: 'Angoli vivi e terminali netti. Tecnico, editoriale.' },
+  twotone: { label: 'Twotone', paint: 'stroke', strokeWidth: 1.5, layers: true, layerOpacity: 0.4, blurb: 'Contorno con i dettagli secondari al 40%.' },
+  duotone: { label: 'Duotone', paint: 'stroke', strokeWidth: 1.5, layers: true, layerOpacity: 0.3, blurb: 'Contorno + riempimento tonale al 30%. Più profondità.' },
+  bulk: { label: 'Bulk', paint: 'stroke', strokeWidth: 1.5, layers: true, layerOpacity: 0.4, blurb: 'Sagoma piena al 40% con i dettagli in primo piano.' },
+  solid: { label: 'Solid', paint: 'fill', blurb: 'Forme piene con dettagli in negativo. Massima leggibilità.' },
+  contained: { label: 'Contained', paint: 'fill', blurb: 'Glifo scavato in un quadrato arrotondato, stile app-icon.' },
+  soft: { label: 'Soft', paint: 'stroke', strokeWidth: 1.5, layers: true, layerOpacity: 0.12, blurb: 'Glifo su tessera tinta al 12%: per chip, liste, empty state.' },
+};
+export const STYLES = Object.keys(STYLE_INFO);
+
+export function rootAttrs(style, { strokeWidth, outlined = false } = {}) {
+  const s = STYLE_INFO[style];
+  if (s.paint === 'fill' || outlined) return { fill: 'currentColor' };
+  return {
+    fill: 'none',
+    stroke: 'currentColor',
+    'stroke-width': strokeWidth ?? s.strokeWidth,
+    'stroke-linecap': s.cap || 'round',
+    'stroke-linejoin': s.join || 'round',
+  };
+}
+
+export function iconNodes(icon, style, { outlined = false } = {}) {
+  if (!outlined) return icon.styles[style].nodes;
+  const { primary, secondary } = icon.styles[style].outline;
+  return [...(secondary ? [['path', { d: secondary, opacity: String(STYLE_INFO[style].layerOpacity) }]] : []), ['path', { d: primary }]];
+}
+
+const esc = (v) => String(v).replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
+const attrs = (o) =>
+  Object.entries(o)
+    .filter(([, v]) => v !== undefined && v !== null && v !== '')
+    .map(([k, v]) => ` ${k}="${esc(v)}"`)
+    .join('');
+
+export function nodesToMarkup(nodes) {
+  return nodes.map(([tag, a]) => `<${tag}${attrs(a)}/>`).join('');
+}
+
+export function toSVG(icon, style, { size = 24, color = 'currentColor', strokeWidth, outlined = false, title } = {}) {
+  const root = {
+    xmlns: 'http://www.w3.org/2000/svg',
+    width: size,
+    height: size,
+    viewBox: '0 0 24 24',
+    ...rootAttrs(style, { strokeWidth, outlined }),
+  };
+  let body = nodesToMarkup(iconNodes(icon, style, { outlined }));
+  if (title) body = `<title>${esc(title)}</title>${body}`;
+  const svg = `<svg${attrs(root)}>${body}</svg>`;
+  return color === 'currentColor' ? svg : svg.replaceAll('currentColor', color);
+}
+
+export const pascal = (name) => name.replace(/(^|-)(\w)/g, (_, __, c) => c.toUpperCase());
+// JS identifiers can't start with a digit: `5g` → Icon5g, `3d-printer` → Icon3dPrinter; the rest → HomeIcon.
+export const componentName = (name) => (/^\d/.test(name) ? `Icon${pascal(name)}` : `${pascal(name)}Icon`);

package/src/server.js

@@ -0,0 +1,95 @@
+// Minimal MCP server over stdio (JSON-RPC 2.0, one message per line). No dependencies.
+import { createInterface } from 'node:readline';
+import { search, getIcon, styles, categories, VERSION, FREE_STYLE, proAvailable } from './core.js';
+
+const SUPPORTED = ['2025-06-18', '2025-03-26', '2024-11-05'];
+const send = (msg) => process.stdout.write(JSON.stringify(msg) + '\n');
+const ok = (id, result) => send({ jsonrpc: '2.0', id, result });
+const fail = (id, code, message) => send({ jsonrpc: '2.0', id, error: { code, message } });
+const text = (t, isError = false) => ({ content: [{ type: 'text', text: t }], ...(isError ? { isError: true } : {}) });
+
+const STYLE_ENUM = styles().map((s) => s.style);
+const TOOLS = [
+  {
+    name: 'search_icons',
+    description: `Search the Nodo Icons catalogue (5,000 UI icons on a 24×24 grid) by name, keyword or synonym. Returns icon names to use with get_icon. Use simple English words, e.g. "upload", "credit card", "settings".`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: { type: 'string', description: 'Words describing the icon, e.g. "trash", "user add", "cloud rain".' },
+        category: { type: 'string', description: 'Optional category filter (see list_categories).' },
+        limit: { type: 'integer', minimum: 1, maximum: 100, default: 20 },
+      },
+      required: ['query'],
+    },
+  },
+  {
+    name: 'get_icon',
+    description: `Get ready-to-paste code for one Nodo icon: inline SVG, a React or Vue component import, or an SVG sprite reference. The "${FREE_STYLE}" style is free (MIT); the other styles are Nodo Icons Pro.`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Exact icon name from search_icons, e.g. "credit-card".' },
+        style: { type: 'string', enum: STYLE_ENUM, default: FREE_STYLE },
+        format: { type: 'string', enum: ['svg', 'react', 'vue', 'sprite'], default: 'svg' },
+        size: { type: 'number', default: 24 },
+        color: { type: 'string', default: 'currentColor', description: 'Any CSS color. Default inherits the text color.' },
+        strokeWidth: { type: 'number', description: 'Only for stroke styles. Default depends on the style (Linear 1.5).' },
+      },
+      required: ['name'],
+    },
+  },
+  { name: 'list_styles', description: 'List the ten Nodo Icons styles, which are free or Pro, and their stroke settings.', inputSchema: { type: 'object', properties: {} } },
+  { name: 'list_categories', description: 'List icon categories with the number of icons in each.', inputSchema: { type: 'object', properties: {} } },
+];
+
+function call(name, a = {}) {
+  switch (name) {
+    case 'search_icons': {
+      const res = search(a.query, { category: a.category, limit: a.limit || 20 });
+      if (!res.length) return text(`No icons match "${a.query}". Try a simpler or more generic word.`);
+      return text(res.map((i) => `${i.name}  (${i.category}; ${i.tags.join(', ')})`).join('\n'));
+    }
+    case 'get_icon': {
+      const r = getIcon(String(a.name || ''), a);
+      return text(r.text, !r.ok);
+    }
+    case 'list_styles':
+      return text(JSON.stringify({ styles: styles(), proFilesConfigured: proAvailable() }, null, 2));
+    case 'list_categories':
+      return text(categories().map((c) => `${c.category}: ${c.count}`).join('\n'));
+    default:
+      return null;
+  }
+}
+
+export function startServer() {
+  const rl = createInterface({ input: process.stdin });
+  rl.on('line', (line) => {
+    if (!line.trim()) return;
+    let msg;
+    try { msg = JSON.parse(line); } catch { return fail(null, -32700, 'Parse error'); }
+    const { id, method, params } = msg;
+    if (id === undefined) return; // notifications (e.g. notifications/initialized) need no reply
+    try {
+      if (method === 'initialize') {
+        const asked = params?.protocolVersion;
+        return ok(id, {
+          protocolVersion: SUPPORTED.includes(asked) ? asked : SUPPORTED[0],
+          capabilities: { tools: {} },
+          serverInfo: { name: 'nodo-icons', version: VERSION },
+          instructions: 'Use search_icons to find an icon name, then get_icon to get SVG or React/Vue code. Prefer the free "linear" style unless the user has Nodo Icons Pro.',
+        });
+      }
+      if (method === 'ping') return ok(id, {});
+      if (method === 'tools/list') return ok(id, { tools: TOOLS });
+      if (method === 'tools/call') {
+        const res = call(params?.name, params?.arguments);
+        return res ? ok(id, res) : fail(id, -32602, `Unknown tool: ${params?.name}`);
+      }
+      return fail(id, -32601, `Method not found: ${method}`);
+    } catch (e) {
+      return fail(id, -32603, e.message);
+    }
+  });
+}