Jinero MCP Server

online.jinero/jinero — размещённый, удалённый сервер Model Context Protocol, который даёт AI-агентам (Claude, Cursor, Cline, Zed, Gemini CLI…) дизайнерские инструменты jinero.online: 22 инструмента только для чтения для шрифтов (поиск, CSS, файлы, распознавание по изображению), цветовой математики (контраст WCAG, оттенки, подбор имён, извлечение палитры), курируемых палитр, минификации/конвертации/определения кода, оптимизации SVG и SCSS-хелперов.

• Эндпоинт: https://jinero.online/mcp (Streamable HTTP)

• Авторизация: нет — анонимно и бесплатно, лимит 60 запросов/мин на IP (плюс отдельные лимиты на тяжёлые инструменты, см. ниже)

• Реестр: online.jinero/jinero в официальном реестре MCP

• Манифест: /.well-known/mcp/server.json

• Документация для людей: jinero.online/dev/mcp — полный справочник с примерами ответов

Подключение

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" }
  }
}

Клиенты, поддерживающие только stdio, могут использовать мост через npx mcp-remote https://jinero.online/mcp.

Related MCP server: memoire

Доверие и безопасность

Каждый инструмент объявляет MCP-аннотации, проверяемые в tools/list:

• все 22 инструмента имеют readOnlyHint: true и idempotentHint: true;

• отправленный код/SVG разбирается и преобразуется как текст — никогда не выполняется и не сохраняется;

• загруженные изображения (распознавание шрифта, извлечение цветов) обрабатываются в памяти и немедленно удаляются;

• только три инструмента загружают URL, указанный пользователем (recognize_font, extract_colors, svg_to_datauri) — помечены openWorldHint: true, с защитой от SSRF и ограничением размера загрузки.

Примечание для автоматических сканеров рисков: некоторые каталоги классифицируют minify_code, convert_code, generate_clamp или recognize_font как «записывающие» инструменты на основе их глаголов. Это чистые функции — текст/математика на входе, текст на выходе; ничего на сервере или на стороне вызывающего не изменяется. Авторитетным сигналом является аннотация readOnlyHint: true, которую каждый из 22 инструментов объявляет в tools/list (снимок в tools.json).

Лимиты запросов

Весь эндпоинт ограничен 60 запросами/мин на IP. Кроме того, вычислительно тяжёлые инструменты имеют собственные лимиты на инструмент и IP (сервер v1.4.0+), которые возвращаются как понятная ошибка инструмента с подсказкой повторить при превышении — каждый лимит также указан в описании инструмента:

Тесты и CI

tests/tools.test.mjs проверяет каждый объявленный инструмент против живого эндпоинта (без зависимостей, Node 20+):

npm test

CI запускает набор тестов при каждом пуше и еженедельно (workflow), а tools.json — зафиксированный снимок живого tools/list — включая схемы и аннотации (npm run update-snapshot для обновления).

Попробуйте без клиента

# 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"}'

Больше запускаемых примеров в examples/.

Справочник инструментов

Сгенерировано из живого tools/list текущей версии сервера.

Шрифты

search_fonts

Поиск по каталогу бесплатных шрифтов по имени, категории, стилевым тегам, языковому покрытию, флагам переменных/моноширинных шрифтов и количеству стилей. Возвращает постраничный список семейств.

только чтение · идемпотентно

recognize_font

Определяет, какой шрифт используется на изображении. Работает на основе НАШЕЙ собственной CNN-модели эмбеддингов, обученной на каталоге шрифтов jinero — она сопоставляет шрифты по визуальной форме/стилю, поэтому НЕ требует OCR и НЕ требует текста (работает для латиницы и кириллицы). Отправьте плотный кроп одной строки текста как image_url (публичный URL) или image_base64 (base64/data-URI, напр. локальный скриншот). Изображение обрабатывается в памяти и немедленно удаляется — никогда не сохраняется. Возвращает наиболее визуально похожие семейства шрифтов с оценками. Быстро (~200 мс).

только чтение · идемпотентно · загружает внешние URL

get_font

Получение полных метаданных одного семейства шрифтов по slug: стили, веса, оси, лицензия, подмножества и URL для скачивания/CSS.

только чтение · идемпотентно

get_font_files

Список всех файлов шрифта (вес/курсив/формат + прямой URL woff2/ttf) для семейства — удобно для создания собственных правил @font-face.

только чтение · идемпотентно

get_fonts_css

Генерация готового CSS @font-face для спецификации семейства (совместимо с Google Fonts), напр. "inter:wght@400,700" или диапазон переменного шрифта "inter:wght@300..900". Возвращает текст CSS.

только чтение · идемпотентно

get_font_download_url

Возвращает прямой URL ZIP-архива для скачивания семейства шрифтов (все стили + готовый fonts.css). НЕ скачивает — передайте URL пользователю или загрузите его отдельно.

только чтение · идемпотентно

Цвета

check_contrast

Проверка коэффициента контрастности WCAG между цветом переднего плана и фона, с прохождением/непрохождением AA/AAA для обычного и крупного текста.

только чтение · идемпотентно

get_color_shades

Инструменты

Цвета

generate_tints

Сгенерируйте оттенки (tints) и тени (shades) для базового цвета (более светлые/тёмные шаги) с hex-значениями.

только чтение · идемпотентный

name_color

Получите ближайшее человекочитаемое название для одного или нескольких цветов. Передайте один hex или несколько через запятую (например, "#3b82f6,#000,#ff7f50"); возвращает каждый входной цвет с ближайшим названием цвета, эталонным hex, флагом точного совпадения и перцептивным расстоянием.

только чтение · идемпотентный

extract_colors

Извлеките палитру доминирующих цветов из изображения. Отправьте либо публичный image_url, либо image_base64 (base64/data-URI, например, локальный скриншот). Изображение обрабатывается в памяти и никогда не сохраняется. Каждый цвет возвращается с его hex, rgb, hsl, долей в изображении и ближайшим человекочитаемым названием цвета — именованная палитра за один вызов.

только чтение · идемпотентный · загружает внешние URL

Палитры

search_palettes

Поиск по каталогу цветовых палитр по имени, тону, температуре, настроению, гармонии, точному количеству цветов и тегам. Возвращает постраничный список.

только чтение · идемпотентный

get_palette

Получите одну цветовую палитру по id: её цвета (hex), имя/производный заголовок, настроение, гармонию, температуру и теги.

только чтение · идемпотентный

Код

minify_code

Минифицируйте или отформатируйте JS, CSS, HTML, SVG, JSON или XML-текст. Установите type=auto для автоматического определения языка. Код только парсится и перепечатывается — никогда не выполняется и не сохраняется.

только чтение · идемпотентный

detect_code

Определите язык/формат фрагмента кода. Только статический анализ — фрагмент никогда не выполняется и не сохраняется.

только чтение · идемпотентный

convert_code

Конвертируйте код между текстовыми форматами (например, JSON↔YAML, CSS↔SCSS). Чистое текстовое преобразование: исходник парсится и пере-сериализуется, никогда не выполняется и не сохраняется. Используйте list_code_converters для получения допустимых from/to id и параметров для каждого конвертера.

только чтение · идемпотентный

list_code_converters

Список доступных конвертеров кода с их from/to id и схемами параметров для каждого конвертера.

только чтение · идемпотентный

Без параметров.

SVG

optimize_svg

Оптимизация/очистка SVG-разметки (SVGO). Чистое преобразование разметки — ничего не выполняется и не сохраняется. Возвращает минифицированный SVG плюс размеры до/после.

только чтение · идемпотентный

svg_to_datauri

Закодируйте SVG (или загруженное изображение) как готовый к использованию в CSS data: URI. Укажите либо сырой svg, либо url.

только чтение · идемпотентный · загружает внешние URL

list_svg_presets

Список доступных пресетов оптимизации SVG и описание каждого.

только чтение · идемпотентный

Без параметров.

Разработка

list_scss_mixins

Список каталога SCSS-миксинов (id, заголовок, краткое описание), опционально отфильтрованный по группе или поиску.

только чтение · идемпотентный

get_scss_mixin

Получите один SCSS-миксин по id: полный исходник, параметры и пример использования.

только чтение · идемпотентный

generate_clamp

Рассчитайте плавное CSS-выражение clamp() для адаптивного размера между двумя ширинами области просмотра. Чистый расчёт — возвращает CSS-фрагмент, ничего не записывает и не сохраняет.

только чтение · идемпотентный

О проекте

Создано и поддерживается jinero.online — бесплатные инструменты для дизайна: шрифты, иконки, цвета и код. MCP-сервер — это тонкая обёртка над тем же публичным REST API: единый контракт, идентичное поведение.

В этом репозитории хранится публичная документация и примеры для сервера. Вопросы и запросы функций для инструментов приветствуются здесь.