yade-mcp

Englisch | 简体中文

O.engines += [LLM()] # yet another engine.

yade-mcp verbindet KI-Agenten mit YADE — der Open-Source-Engine für die Diskrete-Elemente-Methode — über das Model Context Protocol. Durchsuchen Sie API-Dokumentationen, führen Sie Simulationen aus und lassen Sie Code ausführen, alles durch natürliche Konversation.

Ihr Agent ruft nicht nur Tools auf — er sitzt direkt an Ihrer YADE-Konsole, führt eigenständig lange Simulationen aus und bleibt mit Ihren Aktivitäten synchron.

Funktionen

Ihr Agent tippt, YADE führt aus

Unterstützt durch yade_execute_code

Beschreiben Sie in natürlicher Sprache, was Sie möchten. Der Agent gibt Befehle in Ihre YADE-Konsole ein — er inspiziert Partikel, passt Parameter an, lässt die Engine schrittweise laufen und analysiert Ergebnisse. Er liest jede Ausgabe, debuggt und iteriert, genau wie Sie es selbst an der Konsole tun würden.

Starten und zurücklehnen

Unterstützt durch yade_execute_task + yade_check_task_status + yade_interrupt_task

Führen Sie ein vollständiges YADE-Skript als Hintergrundaufgabe aus — genau wie beim Start von yade script.py, nur dass Sie nicht daneben sitzen müssen. Der Agent überwacht den Prozess selbstständig: Er verfolgt die Live-Ausgabe, erkennt auftretende Fehler, stoppt den Lauf bei Unregelmäßigkeiten, korrigiert das Skript und startet es neu — bis die Simulation tatsächlich abgeschlossen ist.

Neue Sitzung, kein Kaltstart

Unterstützt durch yade_list_tasks + yade_check_task_status

Jede Aufgabe, die Sie übermittelt haben — das Skript, die Live-Ausgabe, der Endzustand — bleibt gespeichert. Wenn das Kontextfenster voll ist oder Sie am nächsten Tag zurückkehren, findet ein neuer Agent ein Projekt vor, das sich selbst erinnert: Er listet auf, was ausgeführt wurde, liest die Ergebnisse jeder Aufgabe und macht dort weiter, ohne dass Sie etwas neu erklären müssen.

Eine Live-Shell in die laufende Simulation

Unterstützt durch yade_execute_code

Während eine Aufgabe läuft, hat der Agent eine Live-Shell in die Simulation — lassen Sie ihn beliebige Variablen inspizieren, den Zustand eines Objekts ausgeben oder bei Bedarf einen neuen Plot erstellen, ohne das Skript zu bearbeiten oder den Lauf zu stoppen.

Sie tippen, der Agent ist synchron

Über die übermittelten Aufgaben hinaus fließt jede Zeile, die Sie in die YADE-Konsole eingeben — die Variablen, die Sie geprüft haben, die Parameter, die Sie getestet haben, die Sackgassen, in denen Sie gelandet sind — ebenfalls in den Kontext des Agenten ein. Wenn Sie chatten, kennt er bereits den Pfad dessen, was Sie versucht haben. Lernen Sie YADE und möchten Feedback zu dem, was Sie gerade getippt haben? Hängen Sie bei einem unerwarteten Fehler fest? Fragen Sie einfach — der Agent hat gesehen, was Sie getippt haben und wie YADE geantwortet hat.

Related MCP server: itasca-mcp

Tools (7)

Zwei Dokumentations-Tools (keine Bridge erforderlich) und fünf Ausführungs-Tools (Bridge erforderlich):

Schnellstart

Voraussetzungen

• YADE installiert

• uv installiert (für uvx)

Agenten-Einrichtung (Empfohlen)

Kopieren Sie dies in Ihren KI-Agenten und lassen Sie ihn sich selbst konfigurieren:

Fetch and follow this bootstrap guide end-to-end:
https://raw.githubusercontent.com/yusong652/yade-mcp/master/docs/agentic/yade-mcp-bootstrap.md

Manuelle Einrichtung

1. Registrieren Sie den MCP-Server in Ihrer Client-Konfiguration:

{
  "mcpServers": {
    "yade-mcp": {
      "command": "uvx",
      "args": ["yade-mcp"]
    }
  }
}

2. Starten Sie die Bridge innerhalb von YADE:

pip install yade-mcp-bridge

Dann in einer YADE Python-Konsole:

import yade_mcp_bridge
yade_mcp_bridge.start()

Überprüfung

Starten Sie Ihren KI-Agenten neu (Claude Code, Codex CLI, Gemini CLI, etc.) und bitten Sie ihn, yade_execute_code aufzurufen, um die Verbindung zu überprüfen.

Mitwirken

Siehe CONTRIBUTING.md für die Einrichtung der Entwicklungsumgebung und Richtlinien.

Lizenz

MIT — siehe LICENSE.