OpenAI Image MCP Server

by mindstoneio.github.mindstone/mcp-server-openai-imagev0.3.2

OpenAI image generation MCP server for Model Context Protocol hosts

12Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install OpenAI Image MCP server

claude mcp add openai-image -e OPENAI_API_KEY='<openai-api-key>' -- npx -y @mindstone/mcp-server-openai-image

{
  "mcpServers": {
    "openai-image": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-openai-image"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "openai-image": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-openai-image"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "openai-image": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-openai-image"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "openai-image": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-openai-image"
      ],
      "env": {
        "OPENAI_API_KEY": "<openai-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OPENAI_API_KEY	yes	yes	OpenAI API key with image generation access
MCP_WORKSPACE_PATH	—	—	Workspace directory for saving generated images
OPENAI_IMAGE_MODEL	—	—	Override the default OpenAI image model identifier
OPENAI_IMAGE_REQUEST_TIMEOUT_MS	—	—	Outbound HTTP request timeout in milliseconds (max 1800000)
MCP_ALLOWED_SYMLINK_ROOTS	—	—	JSON array of absolute paths the connector may read through (and write generated images through) in-workspace symlinks that resolve into them. Mirrors the host's built-in file-tool declared-Space roots. Malformed or partially-malformed values fail closed to workspace-only. Optional; standalone users omit it.
MCP_HTTP_PORT	—	—	When set, serve MCP over HTTP on this port bound to 127.0.0.1 (loopback only) instead of stdio. Intended for host-managed local deployments; stdio hosts omit it.

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-10 · 2mo ago · official registry · v0.3.2

FAQ

›How do I install the OpenAI Image MCP server in Claude Code?

Run: claude mcp add openai-image -e OPENAI_API_KEY='<openai-api-key>' -- npx -y @mindstone/mcp-server-openai-image. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does OpenAI Image require an API key?

Yes. It expects OPENAI_API_KEY, of which 1 is a secret.

›Can I use OpenAI Image as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is OpenAI Image in the official MCP registry?

Yes, as io.github.mindstone/mcp-server-openai-image.