OpenAI Image — MCP-сервер генерации картинок
MCP-сервер, который даёт агенту два инструмента: сгенерировать картинку по тексту и отредактировать готовое изображение через OpenAI.
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env OPENAI_IMAGE_MODEL=<OPENAI_IMAGE_MODEL> --env OPENAI_IMAGE_REQUEST_TIMEOUT_MS=<OPENAI_IMAGE_REQUEST_TIMEOUT_MS> --env MCP_ALLOWED_SYMLINK_ROOTS=<MCP_ALLOWED_SYMLINK_ROOTS> --transport stdio openai-image -- npx -y @mindstone/mcp-server-openai-imageЧто делает OpenAI Image
Сервер поднимает инструменты generate_image и edit_image. Первый принимает промпт, размер и качество, второй правит уже существующий файл. Работает через модель gpt-image-2, поддерживает четыре уровня качества и три соотношения сторон, понимает промпты на разных языках.
Готовые PNG складываются только внутри рабочей папки: по умолчанию в ~/Pictures/MCP-Generated-Images/, а если задать MCP_WORKSPACE_PATH — в <workspace>/Chief-of-Staff/generated-images/. Ссылки на файлы за пределами воркспейса сервер отклоняет с кодом WORKSPACE_FENCE_VIOLATION, и это главный источник ошибок при первом запуске: картинку для редактирования придётся сначала перенести в рабочую папку. Ключ API жёстко привязан к api.openai.com, увести его в сторону не получится.
Нужны Node.js 20.3+, npm и ключ OpenAI с доступом к генерации изображений. Без OPENAI_API_KEY сервер всё равно стартует, но каждый вызов вернёт NOT_CONFIGURED вместо падения. Таймаут запроса по умолчанию 180000 мс — под качество high, которое на сложных промптах занимает до двух минут.
Какие задачи решает
- сгенерировать иллюстрацию по текстовому описанию
- поправить готовую картинку через
edit_image - получить PNG в нужном соотношении сторон
- держать сгенерированные файлы внутри рабочей папки
- отдать агенту генерацию картинок без отдельного CLI
Примеры запросов агенту
- Сгенерируй портрет 1024x1536: лошадь везёт телегу на рассвете, качество high
- Отредактируй
hero.png— убери фон и оставь только объект - Сделай квадратную картинку для карточки товара, качество medium
Как установить OpenAI Image
Командой платформы
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env OPENAI_IMAGE_MODEL=<OPENAI_IMAGE_MODEL> --env OPENAI_IMAGE_REQUEST_TIMEOUT_MS=<OPENAI_IMAGE_REQUEST_TIMEOUT_MS> --env MCP_ALLOWED_SYMLINK_ROOTS=<MCP_ALLOWED_SYMLINK_ROOTS> --transport stdio openai-image -- npx -y @mindstone/mcp-server-openai-imageВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add openai-image --env OPENAI_API_KEY=<OPENAI_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --env OPENAI_IMAGE_MODEL=<OPENAI_IMAGE_MODEL> --env OPENAI_IMAGE_REQUEST_TIMEOUT_MS=<OPENAI_IMAGE_REQUEST_TIMEOUT_MS> --env MCP_ALLOWED_SYMLINK_ROOTS=<MCP_ALLOWED_SYMLINK_ROOTS> -- npx -y @mindstone/mcp-server-openai-imageВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"openai-image": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-openai-image"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
"OPENAI_IMAGE_MODEL": "<OPENAI_IMAGE_MODEL>",
"OPENAI_IMAGE_REQUEST_TIMEOUT_MS": "<OPENAI_IMAGE_REQUEST_TIMEOUT_MS>",
"MCP_ALLOWED_SYMLINK_ROOTS": "<MCP_ALLOWED_SYMLINK_ROOTS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"openai-image": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-openai-image"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
"OPENAI_IMAGE_MODEL": "<OPENAI_IMAGE_MODEL>",
"OPENAI_IMAGE_REQUEST_TIMEOUT_MS": "<OPENAI_IMAGE_REQUEST_TIMEOUT_MS>",
"MCP_ALLOWED_SYMLINK_ROOTS": "<MCP_ALLOWED_SYMLINK_ROOTS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -e OPENAI_IMAGE_MODEL=<OPENAI_IMAGE_MODEL> -e OPENAI_IMAGE_REQUEST_TIMEOUT_MS=<OPENAI_IMAGE_REQUEST_TIMEOUT_MS> -e MCP_ALLOWED_SYMLINK_ROOTS=<MCP_ALLOWED_SYMLINK_ROOTS> openai-image npx -y @mindstone/mcp-server-openai-imageВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о OpenAI Image
Как установить Anthropic Image в Claude Code?
Одной командой: claude mcp add mcp-server-openai-image -e OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y @mindstone/mcp-server-openai-image. Если нужны свои воркспейс, модель и таймаут, есть второй вариант с флагами --env для MCP_WORKSPACE_PATH, OPENAI_IMAGE_MODEL, OPENAI_IMAGE_REQUEST_TIMEOUT_MS и MCP_ALLOWED_SYMLINK_ROOTS.
Что делает OpenAI Image?
Даёт агенту два инструмента: генерацию изображения из текстового промпта и редактирование уже существующей картинки. Результат сохраняется в PNG внутри рабочей папки.
Что нужно для работы сервера?
Node.js 20.3+, npm и ключ OpenAI с доступом к генерации изображений. Без ключа сервер запустится, но вызовы инструментов будут возвращать NOT_CONFIGURED.
