Skip to main content
Glama

@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: manim-web

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

Available Tools

1 tool
renderGeometricImageB

Renders an image from Asymptote code.

Inputs: asyCode (required), outputParams.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool has a clearly defined purpose that cannot be confused with any other tool in the set.

    Naming Consistency5/5

    Since there is only one tool, naming consistency is inherently perfect. The tool name 'renderGeometricImage' follows a clear verb_noun pattern, and there are no other tools to compare it against for inconsistency.

    Tool Count2/5

    A single tool is too few for a server named 'MCP Geometry Server', which suggests a broader scope in geometry. This minimal set feels thin and incomplete, likely requiring agents to rely heavily on other servers for basic geometric operations.

    Completeness1/5

    The tool surface is severely incomplete for a geometry domain. It only provides image rendering from Asymptote code, missing obvious operations like calculating areas, distances, transformations, or generating geometric shapes, which are fundamental to geometry.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI to interact with GeoGebra for mathematical visualization, offering over 25 tools for geometry, functions, algebra, and more.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables AI agents to read and analyze math/geometry diagrams, extracting structured data like vectors, matrices, coordinates, and angles with validation and retry logic.
      3
      Apache 2.0