Opencode - как подключить MCP - shinpr/mcp-image - 20/09/2026

Published: 2026-09-09

shinpr/mcp-image — MCP для генерации картинок в OpenCode

shinpr/mcp-image — это MCP-сервер, который позволяет генерировать и редактировать изображения прямо из терминала OpenCode. Поддерживает три провайдера: Gemini (по умолчанию, бесплатный), OpenAI и BytePlus Seedream.

Ключевые возможности:

Автоматическая оптимизация промптов — короткий запрос дорабатывается до детального описания с композицией, освещением и ракурсами
Редактирование существующих изображений — передайте путь к файлу и опишите изменения
Три уровня качества — fast, balanced, quality
Сохранение результатов на диск с возвратом в чат

Требования

Node.js 22 или выше
OpenCode (TUI или desktop)
API-ключ одного из провайдеров (Gemini — бесплатный)

Получение API-ключа Gemini

1. Перейдите на Google AI Studio 2. Нажмите Get API key 3. Скопируйте ключ (начинается с AIza...)

Бесплатный план включает достаточное количество генераций для личного использования.

Конфигурация OpenCode

Отредактируйте файл конфигурации ~/.config/opencode/opencode.json и добавьте блок mcp-image:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcp-image": {
      "type": "local",
      "command": ["npx", "-y", "mcp-image"],
      "enabled": true,
      "environment": {
        "GEMINI_API_KEY": "YOUR_API_KEY_HERE",
        "IMAGE_OUTPUT_DIR": "/Users/username/Pictures/mcp-generated",
        "IMAGE_QUALITY": "balanced"
      }
    }
  }
}

Замените YOUR_API_KEY_HERE на ваш ключ и /Users/username/ на ваш домашний каталог.

Альтернативные провайдеры

Если используете OpenAI или Seedream, измените переменные окружения:

{
  "environment": {
    "IMAGE_PROVIDER": "openai",
    "OPENAI_API_KEY": "sk-...",
    "IMAGE_OUTPUT_DIR": "/Users/username/Pictures/mcp-generated",
    "IMAGE_QUALITY": "balanced"
  }
}

Или для Seedream:

{
  "environment": {
    "IMAGE_PROVIDER": "seedream",
    "ARK_API_KEY": "ваш-ключ",
    "IMAGE_OUTPUT_DIR": "/Users/username/Pictures/mcp-generated",
    "IMAGE_QUALITY": "balanced"
  }
}

Переменные окружения

Параметры конфигурации
Переменная	По умолчанию	Описание
`IMAGE_PROVIDER`	gemini	Провайдер: gemini, openai или seedream
`GEMINI_API_KEY`	—	API-ключ Google Gemini
`OPENAI_API_KEY`	—	API-ключ OpenAI
`ARK_API_KEY`	—	API-ключ BytePlus Seedream
`IMAGE_OUTPUT_DIR`	./output	Директория для сохранения изображений
`IMAGE_QUALITY`	fast	Качество: fast, balanced или quality
`SKIP_PROMPT_ENHANCEMENT`	false	Отключить автооптимизацию промптов

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

После перезапуска OpenCode генерируйте изображения обычным запросом:

# Простая генерация
сгенерируй картинку заката над горами

# С указанием формата
сгенерируй баннер для блога в формате 16:9, минимализм

# Редактирование
отредактируй /path/to/image.jpg — замени фон на космос

Результаты сохраняются в указанную IMAGE_OUTPUT_DIR и возвращаются как MCP-ресурс.

Инструменты MCP

Доступные инструменты
Инструмент !! Описание
`generate_image`	Генерация изображения по текстовому описанию или редактирование существующего
`list_image_models`	Список доступных моделей и поддерживаемых разрешений
`describe_image`	Описание содержимого изображения через vision-модель

Ссылки

×

← В главную