{"_id":"@alonetech/gpt-image-mcp","_rev":"3-6cc2d04b9e25a83c7f9dc46409da1890","name":"@alonetech/gpt-image-mcp","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@alonetech/gpt-image-mcp","version":"0.1.0","keywords":["mcp","gpt-image","image-generation","text-to-image","image-to-image"],"author":{"name":"alonetech"},"license":"MIT","_id":"@alonetech/gpt-image-mcp@0.1.0","maintainers":[{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"}],"homepage":"https://github.com/alonetech/gpt-image-mcp#readme","bugs":{"url":"https://github.com/alonetech/gpt-image-mcp/issues"},"bin":{"gpt-image-mcp":"bin/gpt-image-mcp.js"},"dist":{"shasum":"7b8b5b250be1de3d0f32b5ff31924ba671b4bf8c","tarball":"https://registry.npmjs.org/@alonetech/gpt-image-mcp/-/gpt-image-mcp-0.1.0.tgz","fileCount":7,"integrity":"sha512-T06cs0YSEDZy0YjEf9FnZCgeE61xUbi58PJxYc3eCPl9G+Wmgh7JxIWK13ZP8kVVMjFm5GueIVCbXaO8M3tV5w==","signatures":[{"sig":"MEUCIAMlLNlVJw+t9ZCbRXRS2Amg4uXlQVOfFqv372KsMCu3AiEA1Gh0UWzOOFLC30aLssVchvoPfcR6SFH5X4LEm4WUycQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24988},"type":"module","engines":{"node":">=18.17"},"scripts":{"test":"node --test","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"},"repository":{"url":"git+https://github.com/alonetech/gpt-image-mcp.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP stdio server and CLI for text-to-image and image-to-image generation.","directories":{},"_nodeVersion":"24.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/gpt-image-mcp_0.1.0_1781602075865_0.8600073556872125","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@alonetech/gpt-image-mcp","version":"0.2.0","keywords":["mcp","gpt-image","image-generation","text-to-image","image-to-image"],"author":{"name":"alonetech"},"license":"MIT","_id":"@alonetech/gpt-image-mcp@0.2.0","maintainers":[{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"}],"homepage":"https://github.com/alonetech/gpt-image-mcp#readme","bugs":{"url":"https://github.com/alonetech/gpt-image-mcp/issues"},"bin":{"gpt-image-mcp":"bin/gpt-image-mcp.js"},"dist":{"shasum":"33df3ad2d7a9f5a52d93fdd0a1981484af5c14bb","tarball":"https://registry.npmjs.org/@alonetech/gpt-image-mcp/-/gpt-image-mcp-0.2.0.tgz","fileCount":7,"integrity":"sha512-SmgQzr7a597aPncPAg+6HWPV0sbiCZWNFfhNIcdOU4RFkjFsrJ8Dz4Pqjcyud9E3VsdWsmNHe3SioncfbpH4mw==","signatures":[{"sig":"MEQCIB4ykLz9YW2N8b3IPmgbsFkvwNF98NAMWuU4tp8pANDlAiA7qRTbCkb5CxyNFO78vdGEKmzM22SZtReIcix6g77opg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27339},"type":"module","engines":{"node":">=18.17"},"gitHead":"eb898ec9ada6524905ed0d5a686bd32083058b4f","scripts":{"test":"node --test","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"},"repository":{"url":"git+https://github.com/alonetech/gpt-image-mcp.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP stdio server and CLI for text-to-image and image-to-image generation.","directories":{},"_nodeVersion":"24.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/gpt-image-mcp_0.2.0_1781608515623_0.6520255469771747","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@alonetech/gpt-image-mcp","version":"0.3.0","description":"MCP stdio server and CLI for text-to-image and image-to-image generation.","type":"module","bin":{"gpt-image-mcp":"bin/gpt-image-mcp.js"},"scripts":{"test":"node --test","pack:dry-run":"npm pack --dry-run"},"engines":{"node":">=18.17"},"keywords":["mcp","gpt-image","image-generation","text-to-image","image-to-image"],"author":{"name":"alonetech"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/alonetech/gpt-image-mcp.git"},"bugs":{"url":"https://github.com/alonetech/gpt-image-mcp/issues"},"homepage":"https://github.com/alonetech/gpt-image-mcp#readme","publishConfig":{"access":"public"},"_id":"@alonetech/gpt-image-mcp@0.3.0","gitHead":"df9e2df8ba78491467bde2fbcb3d395b28b33ec3","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-3MTwRZq7wsaQIq/eGFdVuHpV6BNZ3xWSsADpMef4sRB8BUJZf2UsxMf3uax9onbXXlLrJ6Gyl8UUIUPthjqA5w==","shasum":"639194e8b6dee6a20e617787f60547fc29e0f70e","tarball":"https://registry.npmjs.org/@alonetech/gpt-image-mcp/-/gpt-image-mcp-0.3.0.tgz","fileCount":7,"unpackedSize":28683,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCwo+pJdUblWn4k59txDcwKJDx9O5kd4Qu5op1UcRKfLQIhALfaquUTj+OeLKBVKcx8YUKJrD83Qyta0lvsWIS2E1YM"}]},"_npmUser":{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"},"directories":{},"maintainers":[{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gpt-image-mcp_0.3.0_1781611181603_0.5282012797280728"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-16T09:27:55.524Z","modified":"2026-06-16T11:59:41.853Z","0.1.0":"2026-06-16T09:27:56.003Z","0.2.0":"2026-06-16T11:15:15.760Z","0.3.0":"2026-06-16T11:59:41.724Z"},"bugs":{"url":"https://github.com/alonetech/gpt-image-mcp/issues"},"author":{"name":"alonetech"},"license":"MIT","homepage":"https://github.com/alonetech/gpt-image-mcp#readme","keywords":["mcp","gpt-image","image-generation","text-to-image","image-to-image"],"repository":{"type":"git","url":"git+https://github.com/alonetech/gpt-image-mcp.git"},"description":"MCP stdio server and CLI for text-to-image and image-to-image generation.","maintainers":[{"name":"alone_adams_k","email":"wangruanqiang@aliyun.com"}],"readme":"# @alonetech/gpt-image-mcp\n\nMCP stdio server and CLI for OpenAI-compatible image generation APIs.\n\nIt supports:\n\n- Text-to-image: prompt only\n- Image-to-image: prompt plus one or more reference images\n- MCP stdio mode for MCP clients\n- Direct CLI mode for local testing\n\n## Requirements\n\n- Node.js 18.17 or newer\n- An OpenAI-compatible image API `base_url`\n- A bearer token for that API\n\n## CLI\n\nShow help:\n\n```bash\nnpx @alonetech/gpt-image-mcp --help\n```\n\nText-to-image:\n\n```bash\nnpx @alonetech/gpt-image-mcp generate \\\n  --base-url \"https://api.openai.com/v1\" \\\n  --token \"YOUR_TOKEN\" \\\n  --prompt \"An orange cat wearing a space suit, movie poster style\" \\\n  --output \"./cat.png\" \\\n  --size \"1024x1024\" \\\n  --quality \"high\" \\\n  --format \"png\"\n```\n\nImage-to-image:\n\n```bash\nnpx @alonetech/gpt-image-mcp generate \\\n  --base-url \"https://api.openai.com/v1\" \\\n  --token \"YOUR_TOKEN\" \\\n  --prompt \"Turn the references into a clean product image\" \\\n  --image \"./front.png\" \\\n  --image \"./side.jpg\" \\\n  --output \"./product.png\"\n```\n\nOn PowerShell, use backticks instead of backslashes for line continuation.\n\n## MCP Usage\n\nExample MCP server config:\n\n```json\n{\n  \"mcpServers\": {\n    \"gpt-image\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@alonetech/gpt-image-mcp\",\n        \"--base-url\",\n        \"https://api.openai.com/v1\",\n        \"--token\",\n        \"YOUR_TOKEN\"\n      ]\n    }\n  }\n}\n```\n\nFor debugging client startup, add:\n\n```json\n\"--debug-log\",\n\"D:\\\\tmp\\\\gpt-image-mcp-debug.log\"\n```\n\n## MCP Tool\n\nTool name:\n\n```text\ngenerate_image\n```\n\nRequired arguments:\n\n- `prompt`: prompt describing the output image\n- `output`: filesystem path where the generated image will be saved\n\nOptional arguments:\n\n- `images`: reference images as base64 strings or data URLs. Omit or pass an empty array for text-to-image mode.\n- `model`: defaults to `gpt-image-2`\n- `size`: defaults to `auto`\n- `quality`: `auto`, `low`, `medium`, or `high`\n- `background`: `auto`, `transparent`, or `opaque`\n\n`base_url` and `token` are server startup configuration, not per-tool-call arguments.\n\n## Development\n\n```bash\nnpm test\nnpm run pack:dry-run\n```\n\nCreate a local package tarball:\n\n```bash\nnpm pack\n```\n\nTest the tarball:\n\n```bash\nnpx ./alonetech-gpt-image-mcp-0.1.0.tgz --help\n```\n","readmeFilename":"README.md"}