@luorivergoddess/mcp-geo

Сервер MCP (Model Context Protocol) для генерации точных геометрических изображений с использованием Asymptote. Этот сервер позволяет моделям ИИ, совместимым с MCP, запрашивать генерацию изображений, предоставляя код Asymptote.

Предпосылки

Перед использованием этого сервера убедитесь, что у вас установлено следующее:

1. Node.js : рекомендуется версия 16.x или выше. Вы можете загрузить ее с nodejs.org .

2. Asymptote : Это критическая зависимость. Инструмент командной строки asy должен быть установлен и доступен в PATH вашей системы.

   • Посетите официальный сайт Asymptote для загрузки и получения подробных инструкций по установке.

   • Распространенные методы установки:

     • macOS (через Homebrew): brew install asymptote

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

     • Windows: Часто устанавливается как часть дистрибутивов TeX, таких как MiKTeX или TeX Live. Убедитесь, что каталог Asymptote bin добавлен в ваш PATH.

   • Сервер попытается проверить наличие asy -version при запуске и выведет ошибку, если она не будет найдена.

Related MCP server: GGB Web MCP

Установка

Чтобы установить этот пакет глобально (если вы собираетесь запустить команду connect напрямую) или как зависимость в другом проекте:

npm install @luorivergoddess/mcp-geo

Если вы клонировали репозиторий и хотите запустить его локально для разработки:

1. Клонируйте репозиторий.

2. Установка зависимостей: npm install

3. Соберите проект: npm run build

Использование

Запуск сервера

После установки пакета (например, глобально или локально) вы можете запустить сервер MCP с помощью команды connect предоставленной этим пакетом. Эта команда предназначена для вызова клиентом MCP.

npx @luorivergoddess/mcp-geo connect

Или, если вы клонировали репозиторий и собрали его:

node dist/cli.js

Сервер запустится и будет прослушивать сообщения JSON-RPC на stdin/stdout, используя @modelcontextprotocol/sdk .

Интеграция клиента MCP

Настройте MCP-совместимый клиент (например, VS Code с Copilot Agent Mode, Claude Desktop) для использования этого сервера. Обычно это включает в себя указание клиенту, как запустить сервер, что будет командой npx @luorivergoddess/mcp-geo connect .

Доступный инструмент: renderGeometricImage

Сервер предоставляет один основной инструмент:

• Имя: renderGeometricImage

• Описание: Визуализирует изображение из кода Asymptote.

• Схема ввода:

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

• Вывод: инструмент возвращает CallToolResult , содержащий массив частей контента.

  • В случае успеха он включает часть ImageContent со следующими элементами:

    • type: "image"

    • mimeType: "image/svg+xml" или "image/png"

    • data: "<base64_encoded_image_data>"

  • Он также может включать часть TextContent с журналами из Asymptote.

  • Если возникает ошибка, выдается McpError .

Пример вызова renderGeometricImage (JSON для поля arguments ):

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

Примечания по совместимости клиента:

• Некоторые клиенты MCP могут иметь ограничения по поддерживаемым типам MIME изображений.

• Например, если вы используете этот сервер с клиентом, который не поддерживает image/svg+xml (например, определенные версии или конфигурации "Cherry Studio", как сообщалось), убедитесь, что вы запрашиваете формат png , включив "outputParams": { "format": "png" } в аргументы вызова инструмента. Сервер по умолчанию использует svg , если формат не указан.

Автор

luorivergoddess

Лицензия

МСК