@luorivergoddess/mcp-geo

Ein MCP-Server (Model Context Protocol) zur Generierung präziser geometrischer Bilder mit Asymptote. Dieser Server ermöglicht MCP-kompatiblen KI-Modellen die Anforderung der Bildgenerierung durch Bereitstellung von Asymptote-Code.

Voraussetzungen

Stellen Sie vor der Verwendung dieses Servers sicher, dass Folgendes installiert ist:

1. Node.js : Version 16.x oder höher wird empfohlen. Sie können es von nodejs.org herunterladen.

2. Asymptote : Dies ist eine kritische Abhängigkeit. Das Befehlszeilentool asy muss installiert und im PATH Ihres Systems zugänglich sein.

   • Besuchen Sie die offizielle Asymptote-Website zum Herunterladen und für ausführliche Installationsanweisungen.

   • Gängige Installationsmethoden:

     • macOS (über Homebrew): brew install asymptote

     • Debian/Ubuntu Linux: sudo apt-get install asymptote

     • Windows: Wird oft als Teil von TeX-Distributionen wie MiKTeX oder TeX Live installiert. Stellen Sie sicher, dass das Asymptote- bin -Verzeichnis zu Ihrem Pfad hinzugefügt wird.

   • Der Server versucht beim Start, nach asy -version zu suchen und gibt einen Fehler aus, wenn sie nicht gefunden wird.

Related MCP server: GGB Web MCP

Installation

So installieren Sie dieses Paket global (wenn Sie den Befehl „ connect direkt ausführen möchten) oder als Abhängigkeit in einem anderen Projekt:

npm install @luorivergoddess/mcp-geo

Wenn Sie das Repository geklont haben und es lokal für die Entwicklung ausführen möchten:

1. Klonen Sie das Repository.

2. Abhängigkeiten installieren: npm install

3. Erstellen Sie das Projekt: npm run build

Verwendung

Starten des Servers

Sobald das Paket installiert ist (z. B. global oder lokal verknüpft), können Sie den MCP-Server mit dem in diesem Paket bereitgestellten connect -Befehl starten. Dieser Befehl ist für den Aufruf durch einen MCP-Client vorgesehen.

npx @luorivergoddess/mcp-geo connect

Oder, wenn Sie das Repository geklont und erstellt haben:

node dist/cli.js

Der Server wird gestartet und wartet unter Verwendung von @modelcontextprotocol/sdk auf JSON-RPC-Nachrichten auf stdin/stdout.

MCP-Client-Integration

Konfigurieren Sie Ihren MCP-kompatiblen Client (z. B. VS Code mit Copilot-Agent-Modus, Claude Desktop) für die Verwendung dieses Servers. Dazu müssen Sie dem Client in der Regel mitteilen, wie der Server gestartet werden soll. Dies geschieht mit dem Befehl npx @luorivergoddess/mcp-geo connect .

Verfügbares Tool: renderGeometricImage

Der Server stellt ein primäres Tool bereit:

• Name: renderGeometricImage

• Beschreibung: Rendert ein Bild aus Asymptote-Code.

• Eingabeschema:

  {
    "type": "object",
    "properties": {
      "asyCode": {
        "type": "string",
        "description": "A string containing complete and valid Asymptote code to be compiled. The server executes this code directly. Ensure necessary `import` statements (e.g., `import graph;`) and settings (e.g., `unitsize(1cm);`) are included within this code block if needed."
      },
      "outputParams": {
        "type": "object",
        "description": "Optional parameters to control the output image.",
        "properties": {
          "format": {
            "type": "string",
            "enum": ["svg", "png"],
            "description": "The desired output image format. \"svg\" for scalable vector graphics (recommended for diagrams and plots), \"png\" for raster graphics. Defaults to \"svg\" if not specified."
          },
          "renderLevel": {
            "type": "number",
            "description": "For PNG output only. Specifies the rendering quality (supersampling level for antialiasing). Higher values (e.g., 4 or 8) produce smoother images but take longer to render and result in larger files. Asymptote default is 2. This server defaults to 4 if not specified and format is \"png\". Ignored for SVG output."
          }
        }
      }
    },
    "required": ["asyCode"]
  }

• Ausgabe: Das Tool gibt ein CallToolResult zurück, das ein Array von Inhaltsteilen enthält.

  • Bei Erfolg enthält es einen ImageContent Teil mit:

    • type: "image"

    • mimeType: "image/svg+xml" oder "image/png"

    • data: "<base64_encoded_image_data>"

  • Es kann auch einen TextContent Teil mit Protokollen von Asymptote enthalten.

  • Wenn ein Fehler auftritt, wird ein McpError ausgegeben.

Beispiel für renderGeometricImage Aufruf (JSON für das arguments ):

{
  "asyCode": "draw(unitsquare); fill(unitsquare, lightblue);",
  "outputParams": {
    "format": "png",
    "renderLevel": 4
  }
}

Hinweise zur Client-Kompatibilität:

• Bei einigen MCP-Clients können Einschränkungen hinsichtlich der unterstützten Bild-MIME-Typen vorliegen.

• Wenn Sie diesen Server beispielsweise mit einem Client verwenden, der image/svg+xml nicht unterstützt (z. B. bestimmte Versionen oder Konfigurationen von „Cherry Studio“, wie berichtet), stellen Sie bitte sicher, dass Sie das png Format anfordern, indem Sie "outputParams": { "format": "png" } in Ihren Tool-Aufrufargumenten angeben. Der Server verwendet standardmäßig svg , wenn kein Format angegeben ist.

Autor

luorivergoddess

Lizenz

ISC