claude-foundry-image

Плагин для Claude Code, который даёт каждому проекту и каждому разговору генератор изображений на основе вашего собственного развертывания Azure AI Foundry (API MAI image, например MAI-Image-2.5-Pro).

• MCP-сервер (server/server.mjs) — Node ≥ 18, без зависимостей. Инструменты: generate_image, edit_image, check_config.

• Навык generate-image — учит Claude, когда использовать инструменты, как расширить однострочную команду в полезный промпт, допустимые размеры, куда записывать файлы.

• Навык setup — одноразовое прохождение настройки.

Изображения записываются на диск; в диалог попадает только путь к файлу. Никакого base64 в контексте.

Установка

claude plugin marketplace add jpaarhuis/claude-foundry-image

claude plugin install foundry-image@jpaarhuis

Или в интерактивной сессии: /plugin → Marketplaces → добавить jpaarhuis/claude-foundry-image → установить foundry-image.

Related MCP server: gpt-image-mcp

Настройка (один раз)

Сервер читает настройки из переменных окружения. Поместите их в ~/.claude/settings.json в раздел env — один файл, все платформы, видит только Claude Code:

{
  "env": {
    "MAI_IMAGE_ENDPOINT": "https://<resource>.services.ai.azure.com/mai/v1/images/generations",
    "MAI_IMAGE_DEPLOYMENT": "MAI-Image-2.5-Pro",
    "MAI_IMAGE_API_KEY": "<key>",
    "MAI_IMAGE_OUTPUT_DIR": "C:/Users/<you>/Pictures/ai"
  }
}

Или задайте их как переменные окружения пользователя ОС (setx на Windows, export в профиле оболочки на macOS/Linux). В любом случае перезапустите Claude Code.

Затем в любой сессии: "run check_config" или /foundry-image:setup для пошаговой проверки.

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

Просто попросите: "сделай hero-изображение для README, тёмное, изометрическое, без текста". Claude расширяет промпт, выбирает размеры, записывает PNG (в репозиторий, если это уместно) и возвращает путь.

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

Правила размеров из API MAI: каждая сторона ≥ 768 пикселей и ширина × высота ≤ 1 048 576 пикселей. Таким образом, 1024x1024, 1024x768, 1280x800 работают; 1024x1536 и 1920x1080 — нет.

Почему переменные окружения, а не конфигурационный файл или диалог настройки?

У плагинов Claude Code нет отдельного хранилища секретов или интерфейса настройки. Соглашение — то же, что использует официальный плагин GitHub для своего PAT — это подстановка ${VAR} в .mcp.json плагина, при этом пользователь задаёт переменные один раз. settings.json → env — самое удобное место для этого: оно путешествует с вашим профилем Claude Code, применяется к каждому проекту и переживает обновления плагина.

Если вы хотите убрать ключ из текстовых файлов, загрузите его в окружение из хранилища секретов при входе (Key Vault, 1Password CLI, Windows Credential Manager) — серверу всё равно, откуда взялась переменная.

Разработка

npm test

Запускает офлайн-дымовое тестирование: рукопожатие MCP, список инструментов, проверки размеров, ошибки отсутствующей конфигурации и проверяет, что check_config никогда не раскрывает ключ.

Лицензия

MIT