Irasutoya MCP

Hilft Fachkräften, Bilder in der kostenlosen japanischen Illustrationsdatenbank „Irasutoya" zu finden – für Aufklärungsblätter, Arbeitsblätter und Präsentationen.

In taiwanesischen Kliniken und Arztpraxen wird diese Datenbank in Aufklärungsblättern massiv genutzt. Das Problem: Sie funktioniert nur mit japanischen Schlüsselwörtern – Wenn du eine Illustration zu „Aufmerksamkeitsstörung" suchst, musst du auf der Website 集中 oder 気が散る eingeben – und du weißt nicht, was du eingeben sollst.

Der Wert dieses MCP liegt nicht darin, dich mit dem Internet zu verbinden, sondern dir über diese Sprachbarriere hinwegzuhelfen.

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

In fünf Minuten installiert

1. Herunterladen

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

2. Abhängigkeiten installieren

pip install -r requirements.txt

3. In Claude einbinden

Füge in der Konfigurationsdatei claude_desktop_config.json von Claude Desktop Folgendes hinzu:

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

Ersetze C:/Dein-Pfad/ durch den tatsächlichen Speicherort, an den du das Repository geklont hast.

4. Claude neu starten

Kein Konto nötig, kein Schlüssel zu beantragen, keine Umgebungsvariablen zu setzen. So einfach ist das.

Wie groß ist diese Datenbank

Gemessen (2026-08-27):

Du kannst jederzeit mit library_stats die aktuellsten Zahlen selbst abfragen.

Neun Werkzeuge

Abfrageebene

Analyseeebene

Diese Ebene ist der eigentliche Unterschied zwischen dem MCP und „selbst im Browser suchen".

Ausgabeebene

Der vollständige Ablauf zur Erstellung eines Aufklärungsblatts

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

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

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

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

Warum Schritt 2 und 3 getrennt sind

Artifacts haben eine strenge CSP, die alle Bilder von externen Hosts blockiert (die einzige Ausnahme ist Google Fonts). Die Bilder von Irasutoya liegen auf blogger.googleusercontent.com; ein direkter Abruf schlägt also fehl.

Warum also nicht von Anfang an einbetten? Weil ein 400px-Bild als base64 etwa 148 KB groß ist, drei Bilder also 445 KB – diese Zeichen würden, wenn sie durch den Chat laufen, eine große Menge an Kontingent verbrauchen, und du kannst sie ohnehin nicht lesen.

Also: Beim Schreiben URLs verwenden (lesbar), erst im letzten Schritt einbetten (selbstenthaltend). Die Hunderttausende von Zeichen existieren nur in der Datei und gelangen nie in den Chat.

Was das Layout bereits erledigt hat

Das von worksheet_template erzeugte Grundgerüst hat diese Fallstricke bereits ausgefüllt (mit drei Breiten getestet):

Zusätzlich: Beim Drucken wird automatisch auf weißen Hintergrund umgestellt (dunkler Hintergrund verbraucht Toner und ist für Eltern schwer lesbar), und die Links in der Fußzeile werden mit der URL mitgedruckt (damit man weiß, wohin man gehen muss, wenn man das Papier in der Hand hat).

suggest_for_worksheet ist der Kern dieses Tools. Du musst keine Schlüsselwörter selbst zerlegen, sondern beschreibst einfach die Situation:

Ein Kind in der dritten Klasse, überspringt Zeilen beim Lesen, schafft das Abschreiben des Hausaufgabenhefts nicht, die Eltern sind sehr besorgt

Es zerlegt selbst die Linien „Kind / Lernstörung / Hausaufgabenheft / Angst / Eltern", und ordnet jeder Linie ein Bild zu, sodass eine für das Layout nutzbare Kombination entsteht – statt fünf Bilder für dasselbe Konzept.

⚠️ Du beschreibst eine Situation, keinen Einzelfall. Kein Name, keine Krankengeschichte, keine identifizierbaren Informationen – das ist von Natur aus anonymisiert, es sind keine zusätzlichen Compliance-Maßnahmen erforderlich.

🔴 Lizenz: Bitte lies diesen Abschnitt unbedingt

Der Originaltext der Bedingungen von Irasutoya:

Bei kommerzieller Nutzung können bis zu 20 Bilder pro erstelltem Werk kostenlos verwendet werden. Wenn du mehr Bilder benötigst, ist dies kostenpflichtig.

【Traditionelles Chinesisch】 Bei kommerzieller Nutzung sind in einem Werk maximal 20 Bilder kostenlos; darüber hinaus ist es kostenpflichtig, 1.100 Yen pro Bild (inkl. MwSt.).

Es gibt noch eine ebenso wichtige Regel:

Der Verkauf und die Weiterverbreitung des Materials selbst ist verboten.

【Traditionelles Chinesisch】 Das Material selbst darf nicht verkauft und nicht weiterverbreitet werden.

Was das für dich praktisch bedeutet

„In ein Werk einbetten" und „weiterverbreiten" sind zwei verschiedene Dinge

Diese Unterscheidung ist wichtig, weil inline_images tatsächlich Bilder herunterlädt:

inline_images tut Ersteres – dasselbe, als würdest du das Bild in Word einfügen, nur eben in HTML-Schreibweise.

Die dafür getroffenen Designentscheidungen dieses Programms

• Suchwerkzeuge geben nur URLs zurück, laden nichts herunter

• inline_images lädt nur herunter, wenn du es ausdrücklich sagst, und verarbeitet nur Bilder, die bereits in deiner eigenen HTML-Datei vorkommen

• Standardmäßiges Limit von 20 Bildern, genau das kostenlose Limit der Lizenz – das ist keine technische Einschränkung, sondern eine bewusste Grenze

• Das Repository selbst enthält keine Materialdateien

• Jedes Suchergebnis und jede Einbettung endet mit einem Hinweis auf das verbleibende Kontingent

⚠️ Ob kostenlos verteilte Aufklärungsblätter in Kliniken als „kommerziell" gelten, ist eine Grauzone. Der Autor ist kein Anwalt. Praktische Sicherheitslinie: Einzelne Blätter sind unproblematisch, bei Serien ist Vorsicht geboten. Wenn du wirklich große Mengen verwenden möchtest, wende dich bitte direkt an Irasutoya.

Offizielle Erklärung: https://www.irasutoya.com/p/terms.html

Technische Notizen

Irasutoya läuft auf Blogger und hat eine standardmäßige Feed-API, kein HTML-Scraping nötig:

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

Jeder zurückgegebene Eintrag enthält:

• title.$t – Titel (Japanisch)

• link[rel=alternate].href – Seiten-URL

• content.$t – enthält das <img src> der Bilddatei

• category[].term – Tags

robots.txt ist leer (0 Bytes), es gibt keine Crawling-Beschränkungen. Trotzdem hat dieses Programm ein Intervall von 0,8 Sekunden zwischen Anfragen und serielle, nicht parallele Verarbeitung – das ist eine kostenlose Ressource, bring sie nicht zum Absturz.

Chinesisch-Japanische Entsprechungstabelle

Derzeit sind 167 chinesische Begriffe erfasst, die abdecken:

Emotionen (einschließlich feinerer Varianten) / Kinder und Entwicklung / Schule / Familie / Psychologie und Hilfe / Medizin / Langzeitpflege und Senioren / Leben und 3C / Layout-Dekoration / die eigene Situation der Fachkräfte / klinische Themen / Interventionen und Techniken

Davon sind 65 Begriffe tatsächlich über die API verifiziert – alle Kandidaten wurden wirklich einmal gesucht, und was nicht gefunden wurde, wurde direkt entfernt. „Selektiver Mutismus" wurde so entfernt: Das Konzept existiert, aber es gibt kein entsprechendes Material in der Datenbank.

Unerwartete Funde: Sandspiel→箱庭, Brettspiel→ボードゲーム, Bilderbuch→絵本, Kunsttherapie→お絵かき, Token→シール, Burnout→燃え尽き症候群.

Ein chinesischer Begriff kann mehreren japanischen Begriffen entsprechen, weil dasselbe Konzept im Japanischen oft Kanji, Kana und Fremdwörter als drei Schreibweisen hat; nur eine zu verwenden würde einen großen Teil des Materials übersehen.

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

Wenn dir ein Begriff fehlt, ändere einfach ZH_TO_JA in server.py – genau dafür ist es da.

Lizenz

Code: MIT (siehe LICENSE) Illustrationsmaterial: Urheberrecht liegt bei Irasutoya; dieses Projekt besitzt kein Material und verbreitet keins. Bei der Verwendung bitte die oben genannten Lizenzbedingungen beachten.