@luorivergoddess/mcp-geo

Un servidor MCP (Protocolo de Contexto de Modelo) para generar imágenes geométricas precisas con Asymptote. Este servidor permite que los modelos de IA compatibles con MCP soliciten la generación de imágenes mediante el código de Asymptote.

Prerrequisitos

Antes de utilizar este servidor, asegúrese de tener instalado lo siguiente:

1. Node.js : Se recomienda la versión 16.x o superior. Puede descargarla desde nodejs.org .

2. Asíntota : Esta es una dependencia crítica. La herramienta de línea de comandos asy debe estar instalada y accesible en la ruta del sistema.

   • Visita el sitio web oficial de Asymptote para descargar e instalar instrucciones detalladas.

   • Métodos de instalación comunes:

     • macOS (a través de Homebrew): brew install asymptote

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

     • Windows: Suele instalarse como parte de distribuciones de TeX como MiKTeX o TeX Live. Asegúrese de que el directorio bin de Asymptote esté añadido a su PATH.

   • El servidor intentará verificar asy -version al iniciarse e imprimirá un error si no lo encuentra.

Related MCP server: GGB Web MCP

Instalación

Para instalar este paquete globalmente (si desea ejecutar el comando connect directamente) o como una dependencia en otro proyecto:

npm install @luorivergoddess/mcp-geo

Si ha clonado el repositorio y desea ejecutarlo localmente para el desarrollo:

1. Clonar el repositorio.

2. Instalar dependencias: npm install

3. Construya el proyecto: npm run build

Uso

Iniciando el servidor

Una vez instalado el paquete (por ejemplo, globalmente o vinculado localmente), puede iniciar el servidor MCP mediante el comando connect incluido en este paquete. Este comando está diseñado para ser invocado por un cliente MCP.

npx @luorivergoddess/mcp-geo connect

O bien, si ha clonado el repositorio y lo ha creado:

node dist/cli.js

El servidor se iniciará y escuchará los mensajes JSON-RPC en stdin/stdout, utilizando @modelcontextprotocol/sdk .

Integración de clientes MCP

Configure su cliente compatible con MCP (p. ej., VS Code con Copilot Agent Mode, Claude Desktop) para usar este servidor. Esto suele implicar indicarle al cliente cómo iniciar el servidor, lo cual se lograría con el comando npx @luorivergoddess/mcp-geo connect .

Herramienta disponible: renderGeometricImage

El servidor expone una herramienta principal:

• Nombre: renderGeometricImage

• Descripción: Representa una imagen a partir del código Asymptote.

• Esquema de entrada:

  {
    "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"]
  }

• Salida: La herramienta devuelve un CallToolResult que contiene una matriz de partes de contenido.

  • Si tiene éxito, incluye una parte ImageContent con:

    • type: "image"

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

    • data: "<base64_encoded_image_data>"

  • También puede incluir una parte TextContent con registros de Asymptote.

  • Si ocurre un error, se lanza un McpError .

Ejemplo de llamada renderGeometricImage (JSON para el campo arguments ):

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

Notas de compatibilidad del cliente:

• Algunos clientes MCP pueden tener limitaciones en los tipos MIME de imágenes admitidos.

• Por ejemplo, si utiliza este servidor con un cliente que no admite image/svg+xml (p. ej., ciertas versiones o configuraciones de "Cherry Studio", como se ha informado), asegúrese de solicitar el formato png incluyendo "outputParams": { "format": "png" } en los argumentos de la herramienta. El servidor usa svg por defecto si no se especifica ningún formato.

Autor

diosa luoriver

Licencia

ISC