Servidor MCP de Jinero

online.jinero/jinero — un servidor remoto y alojado de Model Context Protocol que brinda a los agentes de IA (Claude, Cursor, Cline, Zed, Gemini CLI…) las herramientas de diseño de jinero.online: 22 herramientas de solo lectura para fuentes (búsqueda, CSS, archivos, reconocimiento a partir de una imagen), matemática de color (contraste WCAG, tonos, nomenclatura, extracción de paletas), paletas seleccionadas, minificación/ conversión/detección de código, optimización de SVG y utilidades de SCSS.

• Endpoint: https://jinero.online/mcp (HTTP Streamable)

• Autenticación: ninguna — anónimo y gratuito, con límite de 60 solicitudes/min por IP (además de límites por herramienta en las herramientas pesadas, ver más abajo)

• Registro: online.jinero/jinero en el registro oficial de MCP

• Manifiesto: /.well-known/mcp/server.json

• Documentación humana: jinero.online/dev/mcp — referencia completa con respuestas de ejemplo

Conectar

Claude Code (CLI):

claude mcp add --transport http jinero https://jinero.online/mcp

Claude Desktop / Cursor / Cline (config):

{
  "mcpServers": {
    "jinero": { "type": "http", "url": "https://jinero.online/mcp" }
  }
}

Los clientes antiguos que solo admiten stdio pueden usar un puente con npx mcp-remote https://jinero.online/mcp.

Related MCP server: memoire

Confianza y seguridad

Cada herramienta declara anotaciones MCP, verificables en tools/list:

• las 22 herramientas son readOnlyHint: true y idempotentHint: true;

• el código/SVG enviado se analiza y transforma como texto — nunca se ejecuta ni se almacena;

• las imágenes subidas (reconocimiento de fuentes, extracción de colores) se procesan en memoria y se eliminan inmediatamente;

• solo tres herramientas obtienen una URL proporcionada por el usuario (recognize_font, extract_colors, svg_to_datauri) — marcadas con openWorldHint: true, con protecciones SSRF y límites de tamaño.

Nota para escáneres de riesgo automatizados: algunos directorios clasifican minify_code, convert_code, generate_clamp o recognize_font como herramientas de "escritura" según sus verbos. Son funciones puras — texto/matemática de entrada, texto de salida; nada se modifica en el servidor ni en el lado del llamador. La señal autoritativa es la anotación readOnlyHint: true que cada una de las 22 herramientas declara en tools/list (capturada en tools.json).

Límites de velocidad

Todo el endpoint está limitado a 60 solicitudes/min por IP. Además, las herramientas de cómputo pesado tienen sus propios límites por herramienta y por IP (servidor v1.4.0+), que se devuelven como un error de herramienta limpio con una sugerencia de reintento cuando se exceden — cada límite también se indica en la descripción de la herramienta:

Pruebas y CI

tests/tools.test.mjs ejercita cada herramienta declarada contra el endpoint en vivo (cero dependencias, Node 20+):

npm test

CI ejecuta la suite en cada push y semanalmente (workflow), y tools.json es una captura confirmada del tools/list en vivo — esquemas y anotaciones incluidos (npm run update-snapshot para actualizar).

Pruébalo sin un cliente

# List all tools
curl -s -X POST https://jinero.online/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Más ejemplos ejecutables en examples/.

Referencia de herramientas

Generada a partir del tools/list en vivo de la versión actual del servidor.

Fuentes

search_fonts

Busca en el catálogo de fuentes gratuitas por nombre, categoría, etiquetas de estilo, cobertura de idiomas, indicadores de variable/monoespaciada y número de estilos. Devuelve una lista paginada de familias.

solo lectura · idempotente

recognize_font

Identifica qué fuente se usa en una imagen. Impulsado por NUESTRO propio modelo de incrustación CNN, entrenado con el catálogo de fuentes de jinero — coincide fuentes por forma/estilo visual, por lo que NO necesita OCR ni texto (funciona para latín y cirílico). Envía un recorte ajustado de una línea de texto como image_url (URL pública) o image_base64 (base64/data-URI, p. ej. una captura de pantalla local). La imagen se procesa en memoria y se elimina inmediatamente — nunca se almacena. Devuelve las familias de fuentes más similares visualmente con puntuaciones. Rápido (~200 ms).

solo lectura · idempotente · obtiene URLs externas

get_font

Obtiene metadatos completos de una familia de fuentes por slug: estilos, pesos, ejes, licencia, subconjuntos y URLs de descarga/CSS.

solo lectura · idempotente

get_font_files

Lista cada archivo de fuente (peso/italica/formato + URL directa woff2/ttf) de una familia — útil para construir reglas @font-face personalizadas.

solo lectura · idempotente

get_fonts_css

Genera CSS @font-face listo para usar para una especificación de familia (compatible con Google Fonts), p. ej. "inter:wght@400,700" o un rango variable "inter:wght@300..900". Devuelve texto CSS.

solo lectura · idempotente

get_font_download_url

Devuelve la URL directa de descarga ZIP de una familia de fuentes (todos los estilos + un fonts.css listo). NO descarga — entrega la URL al usuario o bájala por separado.

solo lectura · idempotente

Colores

check_contrast

Comprueba la relación de contraste WCAG entre un color de primer plano y uno de fondo, con aprobado/fallo AA/AAA para texto normal y grande.

solo lectura · idempotente

get_color_shades

Genera tintes y sombras para un color base (pasos más claros/más oscuros) con valores hexadecimales.

solo lectura · idempotente

name_color

Obtén el nombre legible por humanos más cercano para uno o más colores. Pasa un único hex o varios separados por comas (p. ej. "#3b82f6,#000,#ff7f50"); devuelve cada entrada con el nombre de color más cercano, el hex de referencia, un indicador de coincidencia exacta y la distancia perceptual.

Solo lectura · idempotente

extract_colors

Extrae una paleta de colores dominantes de una imagen. Envía una image_url pública o una image_base64 (base64/data-URI, p. ej. una captura de pantalla local). La imagen se procesa en memoria y nunca se almacena. Cada color se obtiene con su hex, rgb, hsl, la proporción de la imagen y el nombre de color humano más cercano: una paleta con nombre en una sola llamada.

Solo lectura · idempotente · consulta URL externas

Paletas

search_palettes

Busca en el catálogo de paletas de color por nombre, tono, temperatura, ambiente, armonía, cantidad exacta de colores y etiquetas. Devuelve una lista paginada.

Solo lectura · idempotente

get_palette

Obtén una paleta de colores por su id: sus colores (hex), nombre/título derivado, ambiente, armonía, temperatura y etiquetas.

Solo lectura · idempotente

Código

minify_code

Minifica o embellece texto JS, CSS, HTML, SVG, JSON o XML. Si usa type=auto para que detectar el lenguaje. El código solo se parsea y se vuelve a imprimir; nunca se ejecuta ni se almacena.

Solo lectura · idempotente

detect_code

Detecta el lenguaje o formato de un fragmento de código. Solo análisis estático: el fragmento nunca se ejecuta ni se almacena.

Solo lectura · idempotente

convert_code

Convierte código entre formatos de texto (p. ej. JSON↔YAML, CSS↔SCSS). Transformación de texto pura: el origen se parsea y se vuelve a serializar; nunca se ejecuta ni se almacena. Consulta list_code_converters para obtener los identificadores válidos de from/to y las opciones de cada convertidor.

Solo lectura · idempotente

list_code_converters

Lista los convertidores de código disponibles con sus identificadores de from/to y los esquemas de opciones por convertidor.

Solo lectura · idempotente

Sin parámetros.

SVG

optimize_svg

Optimiza/limpia el marcado SVG (SVGO). Transformación de marcado pura: no se ejecuta ni almacena nada. Devuelve el SVG minificado más los tamaños antes/después.

Solo lectura · idempotente

svg_to_datauri

Codifica un SVG (u entonces una imagen descargada) como data: URI listo para CSS. Proporciona el svg na direto o un URL.

Solo lectura · idempotente · consulta URLs externas

list_svg_presets

Lista los preajustes de optimización de SVG disponibles y qué hace cada uno.

Solo lectura · idempotente

Sin parámetros.

Desarrollo

list_scss_mixins

Lista el catálogo de mixins SCSS (id, título, descripción breve), opcionalmente filtrado por grupo o búsqueda.

Solo lectura · idempotente

get_scss_mixin

Obtén un mixin SCSS por su identificador: fuente completa, parámetros y ejemplo de uso.

Solo lectura · idempotente

generate_clamp

Calcula una expresión CSS fluida clamp() para un tamaño adaptable entre dos anchos de viewport. Cálculo puro: devuelve un fragmento CSS y no escribe ni almacena nada.

Solo lectura · idempotente

Acerca de

Construido y mantenido por jinero.online — herramientas de diseño gratuitas para tipografías, iconos, colores y código. El servidor MCP es un capa fina sobre la misma API REST pública: un contrato, el mismo comportamiento.

Este repositorio contiene la documentación pública y ejemplos del servidor. Las pulgas informes de errores y las solicitudes de características para las herramientas son bienvenidas aquí.Generate tints and shades for a base color (lighter/darker steps) with hex values.

read-only · idempotent

name_color

Get the closest human-readable name for one or more colors. Pass a single hex or several comma-separated (e.g. "#3b82f6,#000,#ff7f50"); returns for each input its nearest color name, the reference hex, an exact-match flag and the perceptual distance.

read-only · idempotent

extract_colors

Extract the dominant-color palette from a landscape. Send either a public image_url or image_base64 (base64/data-URI, e.g. a local screenshot). The image is processed in memory and never stored. Each color comes back with its hex, rgb, hsl, share of the image, and the closest human color name — a named palette in a single call.

read-only · idempotent · fetches external URLs

Palettes

search_palettes

Search the color-palette catalog from by name, tone, temperature, brightness, harmony, exact color count and tags. Returns a paginated list.

read-only · idempotent

get_palette

Get one color palette by its ID: its color(s) (hex), name/derived title, mood, harmony, temp. and tags.

read-only · idempotent

Code

minify_code

Minify or beautify JS, CSS, HTML, SVG, JSON, XML. Set type=auto to sniff the language. Code is only parsed and re-printed — never executed and never stored.

read-only · idempotent

detect_code

Detect the language/format of a code snippet. Static analysis only — the snippet is never executed and never stored.

read-only · idempotent

convert_code

Convert code between text formats (e.g. JSON↔YAML, CSS↔SCSS). Pure text transformation: the source is parsed and re-serialized, never executed, ever stored. Use list_code_converters for valid from/to ids and per-converter options.

• read-only · idempotent *

list_code_converters

List available code converters with their convert codes, from/to ids and per-converter option schemas.

read-only · idempotent

No parameters.

SVG

optimize_svg

Optimize/clean SVG markup (SVGO). Pure markup — nothing is executed or stored. Returns minified SVG plus before/after sizes.

read-only · idempotent

svg_to_datauri

Encode an SVG (or graphic images) as a CSS-ready data: URI. Provide raw svg or a url.

read-only · idempotent · fetches external URLs

list_svg_presets

List available SVG optimization presets and what each one does.

read-only · idempotent

No parameters.

Dev

list_scss_mixins

List SCSS mixin catalog (id, title, short description), optionally filtered by group or search.

read-only · idempotent

get_scss_mixin

Get one SCSS mixin by id: full source, parameters, and usage example.

read-only · idempotent

generate_clamp

Calculate fluid CSS clamp() expression for responsive sizing between two viewport widths. Pure calculation — returns a CSS snippet, writes and stores nothing.

read-only · idempotent

About

Built and operated by jinero.online — free design tools for fonts, icons, colors, and code. The MCP server is a thin