いらすとや MCP

Помогает специалистам помогающих профессий искать картинки в бесплатной японской библиотеке иллюстраций «いらすとや» — для раздаточных материалов по санитарному просвещению, учебных листов, презентаций.

Тайваньские больницы и клиники массово используют эту библиотеку в своих материалах. Проблема в том, что она понимает только японские ключевые слова — хочешь найти иллюстрацию «нарушение концентрации внимания» — на сайте нужно вводить 集中 или 気が散る, а ты не знаешь, что именно вводить.

Ценность этого MCP не в том, что он подключается к сети, а в том, что он помогает перешагнуть языковой барьер.

你說：幫我找「注意力不集中」的插圖
它做：認出「注意力」→ 展開成日文「集中」「気が散る」→ 去搜 → 回圖檔網址

Установка за пять минут

1. Склонировать

git clone https://github.com/scatjay/kxmind-irasutoya-mcp.git

2. Установить зависимости

pip install -r requirements.txt

3. Подключить к Claude

В файл настроек Claude Desktop claude_desktop_config.json добавьте:

{
  "mcpServers": {
    "irasutoya": {
      "command": "python",
      "args": ["C:/你的路徑/kxmind-irasutoya-mcp/server.py"]
    }
  }
}

Замените C:/ваш_путь/ на фактическое расположение склонированного репозитория.

4. Перезапустить Claude

Никаких аккаунтов регистрировать не нужно, никаких ключей получать не нужно, никаких переменных окружения задавать не нужно. Всё, на этом всё.

Related MCP server: gemini-image-generator

Насколько большая эта библиотека

Замер (2026-08-27):

В любой момент можно запросить актуальные цифры через library_stats.

Девять инструментов

Слой поиска

Слой анализа

Именно этот слой и есть настоящее отличие MCP от «открыть браузер и искать самому».

Слой вывода

Полный процесс создания раздаточного листа

1. worksheet_template("我的衛教單.html")
      → A4 骨架，列印與手機的坑都填好了

2. search("讀字會跳行")  或  suggest_for_worksheet("…")
      → 拿到圖檔網址，貼進 HTML 的 <img src>
        （這一步刻意用真實網址，檔案才是人看得懂、改得動的）

3. inline_images("我的衛教單.html")
      → 把圖就地換成內嵌，檔案變成自包含

4. 發布成 Artifact
      → 有公開網址可以傳給家長，家長按 Ctrl+P 就能印

Почему шаги 2 и 3 разделены

У Artifact строгий CSP, который блокирует изображения со всех внешних хостов (единственное исключение — Google Fonts). Картинки いらすとや лежат на blogger.googleusercontent.com, так что напрямую они точно не загрузятся.

Почему бы тогда не встраивать сразу? Потому что одна картинка 400px в base64 — это примерно 148 КБ, а три — уже 445 КБ — если эти символы пройдут через диалог, они сожрут огромный объём квоты, и ты при этом ничего в них не поймёшь.

Поэтому: при написании используем URL (читаемо), и только на последнем шаге встраиваем (самодостаточно). Эти сотни тысяч символов существуют только в файле и ни разу не попадают в диалог.

Что уже решено в вёрстке

В каркасе, который генерирует worksheet_template, все эти грабли уже обойдены (проверено на трёх ширинах):

Ещё: при печати фон автоматически становится белым (тёмный фон съедает тонер, да и родителям плохо видно), а ссылки в подвале печатаются вместе с URL (чтобы по бумажной версии было видно, куда идти).

suggest_for_worksheet — ядро этого инструмента. Не нужно самому разбивать на ключевые слова, просто опиши ситуацию:

Ребёнок в третьем классе, при чтении перескакивает через строки, не успевает переписать домашнее задание из дневника, родители очень тревожатся

Он сам разобьёт на линии «ребёнок / нарушение обучаемости / дневник / тревога / родители», и для каждой линии подберёт по одной картинке, собрав комбинацию, которая реально ложится в вёрстку, — а не пять картинок на одно и то же понятие.

⚠️ Ты описываешь ситуацию, а не клинический случай. Ни имён, ни историй болезни, ни идентифицируемой информации — это уже деидентифицировано по своей сути, никаких дополнительных действий по соответствию нормам не требуется.

🔴 Лицензия: этот раздел, пожалуйста, дочитайте до конца

Оригинальный текст правил いらすとや:

商用目的の場合、一つの作成物の中に 20点まで は無料でご利用いただけます。 それ以上の点数をご希望される場合は 有償 となります。

【На традиционном китайском】 При коммерческом использовании в одном произведении можно бесплатно использовать до 20 изображений; свыше — платно, 1 100 иен за штуку (с налогом).

Есть ещё одно не менее важное правило:

素材そのものの販売・再配布は禁止。

【На традиционном китайском】 Сами материалы продавать и распространять повторно запрещено.

Что это значит для тебя на практике

«Встроить в произведение» и «распространять повторно» — это разные вещи

Это различие важно, потому что inline_images действительно скачивает картинки:

inline_images делает первое — то же самое, что вставить картинку в Word, просто в виде HTML.

Какие решения заложены в программу для этого

• Инструменты поиска возвращают только URL и ничего не скачивают

• inline_images скачивает только тогда, когда ты явно об этом просишь, и обрабатывает только те картинки, которые уже есть в твоём собственном HTML-файле

• Лимит по умолчанию — 20 изображений, ровно столько же, сколько бесплатный лимит лицензии — это не техническое ограничение, а осознанная заглушка

• В самом репозитории нет ни одного файла материалов

• После каждого поиска и встраивания в конце выводится напоминание об остатке лимита

⚠️ Считаются ли раздаточные листы, которые клиника раздаёт бесплатно, «коммерческим использованием», — серая зона. Автор не юрист. Практическая безопасная линия: один лист — без проблем, серия — будь осторожен. При действительно масштабном использовании обращайтесь напрямую в いらすとや.

Официальное описание: https://www.irasutoya.com/p/terms.html

Технические заметки

いらすとや работает на Blogger, у него есть стандартный feed API, HTML парсить не нужно:

GET https://www.irasutoya.com/feeds/posts/default?alt=json&q=<日文關鍵字>&max-results=N

Каждая запись в ответе содержит:

• title.$t — заголовок (на японском)

• link[rel=alternate].href — URL страницы

• content.$t — <img src> с файлом картинки внутри

• category[].term — теги

robots.txt пустой (0 байт), никаких ограничений на обход нет. Несмотря на это, в инструмент всё равно заложены интервал между запросами 0,8 секунды, последовательно, без параллелизма — это бесплатный ресурс, не надо класть его на лопатки.

Таблица соответствия китайского и японского

Сейчас собрано 167 китайских слов, охватывающих:

эмоции (включая тонкие оттенки) / дети и развитие / школа / семья / психология и помогающая практика / медицина / долговременный уход и пожилые / быт и 3C / оформительские элементы / ситуации самих помогающих специалистов / клинические темы / интервенции и техники

Из них 65 слов проверены реальными запросами к API — все слова-кандидаты действительно прогонялись через поиск, чего не нашлось — вычёркивалось. Именно так был вычеркнут «селективный мутизм»: понятие существует, но в библиотеке нет соответствующего материала.

Неожиданно ценные находки: 沙盤→箱庭 (песочница→箱庭), 桌遊→ボードゲーム (настольные игры→ボードゲーム), 繪本→絵本 (книжка с картинками→絵本), 藝術治療→お絵かき (арт-терапия→お絵かき), 代幣→シール (жетоны→シール), 耗竭→燃え尽き症候群 (выгорание→燃え尽き症候群).

Одно китайское слово может соответствовать нескольким японским, потому что одно и то же понятие в японском часто имеет три варианта написания: кандзи, кана и заимствование из иностранного языка — если вводить только один вариант, потеряешь добрую половину материалов.

"注意力": ["集中", "気が散る"],
"諮商":   ["カウンセリング", "相談"],
"放鬆":   ["リラックス", "深呼吸", "瞑想"],

Если кажется, что какого-то слова не хватает, просто правь ZH_TO_JA в server.py — он для того и существует.

Лицензия

Код: MIT (см. LICENSE) Иллюстрации: авторские права принадлежат いらすとや, данный проект не владеет и не распространяет никакие материалы, при использовании соблюдайте лицензионные правила выше.