nardoto-mcp-iconfinder 1.0.0

package/README.md

@@ -0,0 +1,19 @@
+# nardoto-mcp-iconfinder
+
+MCP server para buscar e baixar **ícones (SVG/PNG) do Iconfinder** direto no chat.
+
+## Configuração
+- `ICONFINDER_API_KEY` — grátis no free tier em https://developer.iconfinder.com (header Bearer). O free tier dá ~500 req/dia.
+
+## Tools
+- `search_icons` — busca por texto. Por padrão traz só ícones **gratuitos** (`include_premium: false`) para não consumir crédito.
+- `get_icon` — detalhes de um ícone (links SVG/PNG).
+
+As `download_url` retornadas exigem o mesmo header `Authorization: Bearer <key>` para baixar de fato.
+
+## Uso
+```
+npx -y nardoto-mcp-iconfinder
+```
+
+MIT · feito pelo Nardoto.

package/index.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+/**
+ * nardoto-mcp-iconfinder — MCP server pra buscar e baixar icones (SVG/PNG) do Iconfinder.
+ *
+ * Auth: ICONFINDER_API_KEY (Bearer, gratis no free tier em https://developer.iconfinder.com).
+ * Por padrao busca SO icones gratuitos (premium=0) pra nao consumir credito.
+ * As download_url do Iconfinder exigem o mesmo header Authorization: Bearer pra baixar de fato.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js'
+
+const KEY = process.env.ICONFINDER_API_KEY
+const BASE = 'https://api.iconfinder.com/v4'
+
+async function iget(path, params) {
+  if (!KEY) throw new Error('Defina ICONFINDER_API_KEY (gratis em developer.iconfinder.com).')
+  const url = new URL(BASE + path)
+  for (const [k, v] of Object.entries(params || {})) {
+    if (v !== undefined && v !== null && v !== '') url.searchParams.set(k, String(v))
+  }
+  const res = await fetch(url, { headers: { Authorization: 'Bearer ' + KEY, 'User-Agent': 'nardoto-mcp-iconfinder' } })
+  if (!res.ok) throw new Error(`Iconfinder HTTP ${res.status}`)
+  return res.json()
+}
+
+// Extrai a melhor URL SVG (vetor) e a maior PNG (raster) de um icone.
+function fmtIcon(icon) {
+  let svg = null
+  for (const vs of icon.vector_sizes || []) {
+    for (const f of vs.formats || []) {
+      if ((f.format || '').toLowerCase() === 'svg' && f.download_url) { svg = f.download_url; break }
+    }
+    if (svg) break
+  }
+  let png = null
+  let bestSize = 0
+  for (const rs of icon.raster_sizes || []) {
+    const size = rs.size_width || rs.size || 0
+    for (const f of rs.formats || []) {
+      if ((f.format || '').toLowerCase() === 'png' && f.download_url && size >= bestSize) {
+        png = f.download_url; bestSize = size
+      }
+    }
+  }
+  return {
+    icon_id: icon.icon_id,
+    tags: Array.isArray(icon.tags) ? icon.tags.slice(0, 12) : undefined,
+    is_premium: icon.is_premium,
+    svg_download_url: svg,
+    png_download_url: png,
+    png_size: bestSize || undefined,
+    nota_download: 'As download_url exigem o header Authorization: Bearer <sua key> pra baixar.',
+  }
+}
+
+const TOOLS = [
+  {
+    name: 'search_icons',
+    description: 'Busca icones no Iconfinder por texto. Por padrao traz so icones gratuitos (nao consome credito). Retorna links de download SVG e PNG.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: { type: 'string', description: 'Termo de busca (ex: cross, sword, crown, map, scale, dove)' },
+        limit: { type: 'number', description: 'Maximo de resultados (1-50, padrao 12)' },
+        include_premium: { type: 'boolean', description: 'Incluir icones premium (consome credito). Padrao false.' },
+      },
+      required: ['query'],
+    },
+  },
+  {
+    name: 'get_icon',
+    description: 'Detalhes de um icone pelo icon_id (tags, links de download SVG/PNG).',
+    inputSchema: { type: 'object', properties: { icon_id: { type: 'string', description: 'ID do icone' } }, required: ['icon_id'] },
+  },
+]
+
+const server = new Server({ name: 'nardoto-mcp-iconfinder', version: '1.0.0' }, { capabilities: { tools: {} } })
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }))
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const { name, arguments: args = {} } = req.params
+  try {
+    if (name === 'search_icons') {
+      if (!args.query) throw new Error('query obrigatoria')
+      const params = {
+        query: args.query,
+        count: Math.min(Math.max(Number(args.limit) || 12, 1), 50),
+        premium: args.include_premium ? 'all' : '0',
+        vector: 1,
+      }
+      const data = await iget('/icons/search', params)
+      const icons = (data.icons || []).map(fmtIcon)
+      return { content: [{ type: 'text', text: JSON.stringify({ count: icons.length, total: data.total_count, icons }, null, 2) }] }
+    }
+    if (name === 'get_icon') {
+      if (!args.icon_id) throw new Error('icon_id obrigatorio')
+      const icon = await iget(`/icons/${encodeURIComponent(args.icon_id)}`, {})
+      return { content: [{ type: 'text', text: JSON.stringify(fmtIcon(icon), null, 2) }] }
+    }
+    return { content: [{ type: 'text', text: 'Tool desconhecida: ' + name }], isError: true }
+  } catch (e) {
+    return { content: [{ type: 'text', text: 'Erro: ' + (e?.message || String(e)) }], isError: true }
+  }
+})
+
+await server.connect(new StdioServerTransport())
+console.error('[nardoto-mcp-iconfinder] pronto (stdio)')

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "nardoto-mcp-iconfinder",
+  "version": "1.0.0",
+  "description": "MCP server para buscar e baixar icones (SVG/PNG) do Iconfinder",
+  "type": "module",
+  "bin": {
+    "nardoto-mcp-iconfinder": "index.js"
+  },
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "iconfinder",
+    "icons",
+    "svg",
+    "nardoto"
+  ],
+  "author": "Nardoto",
+  "license": "MIT"
+}