MCP ECharts: MCP-Tool zur Erstellung von ECharts-Visualisierungsdiagrammen

mcp-echarts ist ein Werkzeug, das es KI Large Language Models (LLMs) ermöglicht, dynamisch visuelle Diagramme von Apache ECharts zu erstellen. Es fungiert als Model Context Protocol (MCP)-Server, den KI-Assistenten aufrufen können, um auf der Grundlage von Benutzereingabebefehlen und -daten umfangreiche Diagramme zu erstellen. Der Benutzer kann der KI zum Beispiel sagen: "Erstelle ein Balkendiagramm für diese Verkaufsdaten", und die KI wird mcp-echarts verwenden, um das Diagramm zu erstellen. Dieses Tool zeichnet sich dadurch aus, dass es vollständig lokal läuft, ohne auf irgendwelche Remote-Dienste angewiesen zu sein, was die Datensicherheit gewährleistet. Gleichzeitig ist es einfach zu installieren und kann in den MinIO-Objektspeicher integriert werden, um die erzeugten Diagramme in Form von Links gemeinsam zu nutzen, was die Effizienz der Übertragung und gemeinsamen Nutzung verbessert. Auf diese Weise gibt mcp-echarts KI-Anwendungen die Möglichkeit, dynamische Daten zu visualisieren und ermöglicht eine intuitivere Datenanalyse und Ergebnispräsentation.

Funktionsliste

• Vollständige ECharts-UnterstützungVollständige Unterstützung für alle Funktionen und die Syntax von Apache ECharts, einschließlich Daten, Stile, Themen und mehr.
• Mehrere ExportformateUnterstützt den Export der erzeugten Diagramme als pngundsvg Bildformat, oder die Ausgabe von ECharts option Konfigurationsdatei.
• GrammatikprüfungEine integrierte Kalibrierungsfunktion, die KI-Modellen hilft, mehrere Dialogrunden zu durchlaufen und schließlich syntaktisch korrekte Diagrammkonfigurationen auszugeben.
• MinIO-IntegrationIntegration mit dem Objektspeicherdienst MinIO. Wenn diese Funktion aktiviert ist, werden die generierten Diagramme zu MinIO hochgeladen und geben einen URL-Link anstelle eines Base64-Datenstroms zurück, der sich besser für die Übertragung und gemeinsame Nutzung im Netzwerk eignet. Wenn MinIO nicht konfiguriert ist, schaltet das Tool automatisch auf die Ausgabe im Base64-Format zurück.
• Leichter EinbauDies kann geschehen durch npx Befehle werden direkt ausgeführt, ohne komplizierte Installationsprozesse und externe Abhängigkeiten.
• Lokalisierter BetriebDer Prozess der Diagrammerstellung findet vollständig auf dem lokalen Computer statt und kommuniziert nicht mit einem entfernten Server, wodurch die Sicherheit von Daten und Privatsphäre gewährleistet wird.
• Mehrere KommunikationsprotokolleUnterstützt die Verwendung der Standard-Ein- und Ausgänge (stdio), sendet der Server ein Ereignis (sse) und Streaming (streamable) und viele andere Protokolle zur Integration mit KI-Anwendungen.

Hilfe verwenden

Im Kern fungiert mcp-echarts als Hintergrunddienst, den KI-Anwendungen (z. B. Claude auf dem Desktop, VSCode-Plugins usw.) aufrufen können, um Diagramme zu erstellen. Die Benutzer bedienen mcp-echarts in der Regel nicht direkt, sondern konfigurieren KI-Anwendungen so, dass sie es verwenden.

1) Schnellstart (Integration von Desktop-Anwendungen)

Dies ist die häufigste Verwendung, wobei mcp-echarts in den Einstellungen der KI-App als verfügbares Tool angegeben ist.

Verfahren zur Konfiguration::
In der Konfigurationsdatei für AI-Anwendungen, die das MCP-Protokoll unterstützen (z. B. Claude Desktop Edition, VSCode usw.), fügen Sie die mcpServers Teil.

• Unter macOS::

{
"mcpServers": {
"mcp-echarts": {
"command": "npx",
"args": [ "-y", "mcp-echarts" ]
}
}
}

• Auf Windows-Systemen::

{
"mcpServers": {
"mcp-echarts": {
"command": "cmd",
"args": [ "/c", "npx", "-y", "mcp-echarts" ]
}
}
}
```配置完成后，当你在这些应用中向AI发出绘图指令时，AI就会自动调用 `npx -y mcp-echarts` 命令来执行图表生成任务。 `npx -y` 会自动下载并运行最新版本的 mcp-echarts，无需用户手动安装。
### **2. 作为独立服务器运行**
如果你需要将 mcp-echarts 作为一个独立的HTTP服务部署，供其他网络应用（如 glama.ai, smithery.ai 等）调用，可以采用SSE或Streamable模式运行。
**安装**：
首先，需要通过 npm 将其全局安装到你的系统中。
```bash
npm install -g mcp-echarts

Neue Dienste::
Wählen Sie ein Transportprotokoll, um den Dienst nach Bedarf zu starten.

• Läuft auf SSE-Protokoll (Server-Sent Events)::

  mcp-echarts -t sse
  

  Wenn der Dienst gestartet wird, lauscht er standardmäßig auf der http://localhost:3033/sse.

• Läuft auf Streamable-Protokoll::

  mcp-echarts -t streamable
  

  Wenn der Dienst gestartet wird, lauscht er standardmäßig auf der http://localhost:3033/mcp.

Kommandozeilen-Optionen::
Sie können die Konfiguration des Dienstes mit Befehlszeilenparametern anpassen. ausführen mcp-echarts -h Alle verfügbaren Optionen anzeigen.

• --transport, -tTransportprotokoll: Gibt das Transportprotokoll an, mit einem optionalen Wert von stdio (Voreinstellung),sse vielleicht streamable.
• --port, -pfür sse vielleicht streamable Das Protokoll gibt den zu überwachenden Port an (der Standard ist 3033).
• --endpoint, -eSSE: Geben Sie den Zugriffspfad für das Transportprotokoll an (z. B. SSE ist standardmäßig auf /sse).

3 (Optional) Konfigurieren von MinIO Object Storage

Für eine bessere Leistung und gemeinsame Nutzung können Sie mcp-echarts so konfigurieren, dass die generierten Diagrammbilder in MinIO oder andere S3-kompatible Objektspeicherdienste hochgeladen werden.

Schritt 1: Starten Sie den MinIO-Dienst
Zunächst müssen Sie einen MinIO-Dienst entweder lokal oder auf einem Server laufen lassen. Wenn Sie macOS als Beispiel verwenden, können Sie den brew Schnelle Installation und Inbetriebnahme.

# 安装 MinIO
brew install minio/stable/minio
# 启动 MinIO 服务，数据将存储在 ~/minio-data 目录
minio server ~/minio-data --console-address :9001

Schritt 2: Umgebungsvariablen konfigurieren
Erstellen Sie im Stammverzeichnis des mcp-echarts-Projekts ein .env Datei. Sie können die Datei von der Seite .env.example Machen Sie eine Kopie für den Anfang.

cp .env.example .env```
然后，编辑 `.env` 文件，填入你的MinIO服务器信息：
```env
MINIO_ENDPOINT=localhost
MINIO_PORT=9000
MINIO_USE_SSL=false
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET_NAME=mcp-echarts

Bitte stellen Sie sicher, dass MINIO_BUCKET_NAME Der angegebene Speicher-Bucket (Bucket) wurde in MinIO erstellt. Nach der Konfiguration lädt mcp-echarts die Diagramme hoch, nachdem sie generiert wurden, und gibt eine URL zurück. Wenn die MinIO-Verbindung fehlschlägt, wird automatisch ein Downgrade durchgeführt und die Base64-Kodierung des Bildes zurückgegeben.

Anwendungsszenario

1. AI-Assistent Datenvisualisierung
   Bei der Datenanalyse mit einem KI-Assistenten, wie z. B. den in VSCode oder Claude integrierten Assistenten, können die Nutzer der KI befehlen, Diagramme direkt in natürlicher Sprache zu erstellen. So kann ein Nutzer beispielsweise eine CSV-Datei hochladen und sagen: "Bitte erstellen Sie ein Liniendiagramm mit den monatlichen Umsätzen auf der Grundlage der Daten in dieser Datei".
2. Automatisierte Berichterstellung
   In Systemen, die automatisch Datenanalyseberichte erstellen, kann mcp-echarts als Kernkomponente verwendet werden. Nach der Analyse der Daten kann das Programm den mcp-echarts-Dienst aufrufen, um Schlüsseldaten und Schlussfolgerungen in Diagramme und Grafiken umzuwandeln und in das endgültige Berichtsdokument einzubetten, um den Berichtsinhalt lesbarer zu machen.
3. Online-Plattform zur Datenanalyse
   Webanwendungen oder Online-Datenanalyseplattformen können mcp-echarts als Back-End-Engine zur Diagrammerstellung integrieren. Die Benutzer bearbeiten die Daten auf der Front-End-Schnittstelle, und das Back-End der Plattform sendet die Daten und die Diagrammkonfiguration an den mcp-echarts-Dienst, der die Visualisierungsergebnisse dynamisch generiert und sie den Benutzern anzeigt.

QA

1. Was ist MCP?
   MCP (Model Context Protocol) ist ein Protokoll, das es Large Language Models (LLMs) ermöglicht, mit externen Tools oder Diensten zu interagieren. mcp-echarts ist ein serverseitiges Tool, das das Protokoll implementiert, mit dem KI-Modelle die Möglichkeit haben, ECharts-Diagramme zu erstellen, indem sie diesen Dienst aufrufen.
2. Welche Diagrammtypen werden von mcp-echarts unterstützt?
   Es unterstützt theoretisch alle Diagrammtypen und Funktionen, die von Apache ECharts unterstützt werden. Da sein Kernprinzip darin besteht, die ECharts-Diagramme zu empfangen und darzustellen option Konfigurationen. Solange das KI-Modell die richtigen Konfigurationen generiert, ist diemcp-echarts Es kann sie darstellen, einschließlich der üblichen Balkendiagramme, Liniendiagramme, Tortendiagramme, Streudiagramme und komplexere Baumdiagramme, Sonnenaufgangsdiagramme usw.
3. Brauche ich eine Internetverbindung, um mcp-echarts zu nutzen?
   Das ist nicht nötig.mcp-echarts Die gesamte Diagrammerstellung erfolgt lokal, ohne auf externe Cloud-Dienste zurückzugreifen, wodurch der Datenschutz und die Sicherheit der Datenverarbeitung gewährleistet werden. Es wird nur dann eine Verbindung zu dem von Ihnen angegebenen MinIO-Server hergestellt, um Bilder hochzuladen, wenn Sie den MinIO-Objektspeicher konfiguriert haben.
4. Warum empfehlen Sie MinIO?
   Wenn AI ein Diagramm generiert, ist es in der Regel notwendig, das Diagramm (ein Bild) zur Anzeige an das Frontend zurückzugeben. Wenn die Base64-Kodierung des Bildes direkt zurückgegeben wird, ist die Datenmenge groß und die Übertragungseffizienz gering. Mit MinIO können Sie das Bild in einem Objektspeicher speichern und eine Kurz-URL zurückgeben. Das Front-End kann dann einfach die URL laden, was effizienter ist und die gemeinsame Nutzung und Verwaltung des generierten Diagramms erleichtert.