Dokumentation · MCP für KI-Agenten

Diagramme über MCP

Ein KI-Diagramm-Maker im wörtlichen Sinn: Verbinde Claude, ChatGPT, Cursor, Codex oder einen anderen Assistenten mit Unterstützung für das Model Context Protocol mit diesem Projekt. Er erhält fünf gemeinsame Werkzeuge. Der lokale Server ergänzt render_card, insgesamt also sechs Werkzeuge. Beschreibe die Daten und erhalte eine geprüfte Spezifikation, Einbettungscode oder ein fertiges Bild.

Zwei Verbindungswege

https://meikucharts.com/mcp

Die fünf gemeinsamen Werkzeuge

prepare_visualization

Beginne mit deinen Daten und der gewünschten Aussage. Dein Assistent erhält eine vollständige Tabelle oder ein Diagramm, fertigen Einbettungscode und eine Erklärung der ausgewählten Funktionen. Lange Tabellen erhalten eine Suche und fixierte Überschriften. Ausdrückliche Einstellungen und mitgelieferte Einschränkungen bleiben erhalten.

prepare_visualization({
  "data": {
    "columns": ["Product", "Monthly cost", "Support"],
    "rows": [["A", 20, "yes"], ["B", 40, "partial"]]
  },
  "title": "Plan comparison"
})

Ein Ergebnis mit ready kann sofort angezeigt werden. Optionale Fragen, etwa nach einer Quelle, verhindern das nicht. Ein Ergebnis mit needs_input benennt eine notwendige Korrektur und enthält keinen Einbettungscode. Mehrdeutige Zahlen bleiben Text; fehlende Beobachtungen werden niemals zu erfundenen Nullen. Für Zellen mit ausführlichen Hinweisen oder eine vorhandene Visualisierung übergibst du die vollständige spec statt data.

Setze bei numerischen Daten intent auf compare, trend, share oder point. Verwende share nur für Teile eines Ganzen. Die aktuellen Beschriftungen können Zahlen runden oder abkürzen. Die Antwort warnt, wenn exakte Ausgangswerte ergänzenden Text benötigen. Füge strukturierte Daten statt roher CSV-Daten ein, damit leere Zellen und Dezimaltrennzeichen eindeutig bleiben.

create_chart

Spezifikation hinein, Einbettungscode heraus. Zuerst prüft der eigene Parser der Engine die Spezifikation. Der Assistent erhält somit eine geprüfte Spezifikation. Bei Fehlern erhält er strukturierte Meldungen mit {path, message, hint}, die Assistenten beim zweiten Versuch meist gut korrigieren können.

create_chart({
  "type": "column",
  "theme": "editorial",
  "data": {
    "labels": ["Q1", "Q2", "Q3", "Q4"],
    "series": [{ "name": "Revenue", "values": [48, 52, 47, 61] }]
  }
})
// -> a validated, paste-ready <live-chart> embed snippet

Für eine Tabellenwarnung mit eigener Erklärung bleibt die Spalte Text. Übergib als Zelle { "text": "Limited claim", "kind": "warn", "note": "Full explanation" }. Die Schaltfläche ! öffnet die vollständige Anmerkung mit bis zu 4000 Unicode-Zeichen. noteText und detail werden nicht unterstützt. Prüfe vor dem Einfügen, ob die zurückgegebene normalisierte Spezifikation deine Anmerkung enthält. Du kannst die vollständige Spezifikation im Tabellen-Maker einfügen und JSON herunterladen, um typisierte Zellen und Layout zu erhalten.

suggest_chart

Datenzeilen hinein, Empfehlung heraus: Das Werkzeug prüft die Datenstruktur, also Anzahl der Reihen und Punkte sowie ganzzahlige Werte. Es liefert einen Diagrammtyp, die Begründung und eine fertige Spezifikation für die anderen Werkzeuge.

list_themes

Zehn Gestaltungen: fünf Themes, jeweils hell und dunkel, mit genügend Beschreibung zur Auswahl eines passenden Stils für die Zielseite. Ein Abgleichstest hält sie mit dem Theme-Verzeichnis der Engine synchron.

render_chart

Die gesamte Verarbeitung in einem Aufruf: Spezifikation hinein, fertiges Bild direkt ins Gespräch. Der KI-Connector rendert SVG durch reine Berechnung, ganz ohne Browser. Das lokale MCP rendert zusätzlich PNG mit einem Browser ohne Oberfläche in doppelter Auflösung. Gehostetes PNG ist geplant.

render_chart({
  ...the same spec fields...
  "format": "svg"   // hosted renders SVG; the local MCP adds "png"
})
// -> the finished image, straight into the conversation

Das sechste Werkzeug: lokale Infografik-Karten

render_card

Das lokale MCP rendert mit render_card auch Infografik-Karten über dein installiertes Chrome oder Edge. Dieses Werkzeug gibt es nur auf dem lokalen Server, zusätzlich zu den fünf gemeinsamen Werkzeugen.

Wichtige Grenzen

Der KI-Connector enthält pro Monat 10 Visualisierungen mit Free, 500 mit Pro und 5.000 mit Team. Diagramme und Tabellen teilen ein Kontingent pro Konto. Es wird am 1. jedes Monats (UTC) zurückgesetzt. Diagramme im KI-Connector unterstützen bis zu 1.000 Punkte mit Free und 5.000 Punkte mit Pro und Team.

Eine Einbettung zu erstellen, eine Visualisierung mit Ergebnis ready vorzubereiten oder ein Diagramm zu rendern verbraucht jeweils eine Visualisierung. Vorschläge und Theme-Listen verbrauchen kein Kontingent. Nur erfolgreiche Ergebnisse zählen. Bei 80 % erhältst du eine Warnung. Das Erstellen und anschließende Rendern desselben Diagramms zählen als getrennte Nutzungen.

Zusätzlich gelten Schutzgrenzen für Eingaben und Rendering: höchstens 10.000 Werte pro Aufruf, höchstens 10.000 gezeichnete Punkte in einem Punktdiagramm und PNG-Bilder mit höchstens 16,8 Millionen Pixeln. Diese Grenzen erhöhen weder das Cloud-Punktelimit noch das monatliche Kontingent deines Tarifs. Beachte Aufforderungen, Anfragen zu verlangsamen. Fehler haben dieselbe strukturierte Form wie sonst.

Der Connector rendert SVG, das lokale MCP zusätzlich PNG. Lies die Nutzungsrichtlinie und Lizenzbedingungen.