{"_id":"@agentrix/gemini-image-mcp","_rev":"5-dea490a21bc4669f0013dc1bb0febb49","name":"@agentrix/gemini-image-mcp","dist-tags":{"latest":"1.1.4"},"versions":{"1.1.0":{"name":"@agentrix/gemini-image-mcp","version":"1.1.0","keywords":["mcp","gemini","image-generation","ai","banana"],"author":"","license":"MIT","_id":"@agentrix/gemini-image-mcp@1.1.0","maintainers":[{"name":"xmz.ai","email":"saizhuolin@gmail.com"}],"homepage":"https://github.com/xmz-ai/agentrix-mcp-tools#readme","bugs":{"url":"https://github.com/xmz-ai/agentrix-mcp-tools/issues"},"bin":{"gemini-image-mcp":"dist/index.js"},"dist":{"shasum":"2684ab86fefc79097e23c64ebaf9ce8b403769fe","tarball":"https://registry.npmjs.org/@agentrix/gemini-image-mcp/-/gemini-image-mcp-1.1.0.tgz","fileCount":9,"integrity":"sha512-s2hZYcfkCIt13u1SRQ9/rTlPZqc7/sdaaEcDP1fB5fIMUTkRRx01KqrxizlYUmRzWI4nXD88+sfsNolpdNjsig==","signatures":[{"sig":"MEUCIQC+rrDUelynti+mjL0dQgu1zisdyj9usqVQZ9h+pjpzPwIgO2oCfYT7MCKr8pEXWcNwmpu1kEiyrbU2FSLT0t4/YVc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentrix%2fgemini-image-mcp@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1414611},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"540cb3a21f9346a59a0e692490c2685b27edcda3","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"xmz.ai","email":"saizhuolin@gmail.com"},"repository":{"url":"git+https://github.com/xmz-ai/agentrix-mcp-tools.git","type":"git","directory":"gemini-image-mcp"},"_npmVersion":"10.8.2","description":"MCP server for generating images using Gemini Banana API","directories":{},"_nodeVersion":"20.19.6","dependencies":{"axios":"^1.7.9","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/gemini-image-mcp_1.1.0_1768472306998_0.7003593866847126","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@agentrix/gemini-image-mcp","version":"1.1.1","keywords":["mcp","gemini","image-generation","ai","banana"],"author":"","license":"MIT","_id":"@agentrix/gemini-image-mcp@1.1.1","maintainers":[{"name":"xmz.ai","email":"saizhuolin@gmail.com"}],"homepage":"https://github.com/xmz-ai/agentrix-mcp-tools#readme","bugs":{"url":"https://github.com/xmz-ai/agentrix-mcp-tools/issues"},"bin":{"gemini-image-mcp":"dist/index.js"},"dist":{"shasum":"8aaff47f56079c004fc967cc6ac891e2e33dc54c","tarball":"https://registry.npmjs.org/@agentrix/gemini-image-mcp/-/gemini-image-mcp-1.1.1.tgz","fileCount":9,"integrity":"sha512-aDLGoQg7pOVXMxHls+kbAZ56xVP8Z+L8SQ8C6DzWciXyFNYkxaa/druU4Q8BHhWziYcmxMtSM3eb5FIdCPbV0A==","signatures":[{"sig":"MEUCIQC3UKy5Qg42eb2XaOUu3xaR3cJmN3XlBzdUqvFIoF2emgIgK6z9uiLzz6K/T/GtTqUlLB3aLsv3y3ACKzOW7xZV1do=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentrix%2fgemini-image-mcp@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1415297},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"f02f774daeeb858201f7139d53318da28ad312eb","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"xmz.ai","email":"saizhuolin@gmail.com"},"repository":{"url":"git+https://github.com/xmz-ai/agentrix-mcp-tools.git","type":"git","directory":"gemini-image-mcp"},"_npmVersion":"10.8.2","description":"MCP server for generating images using Gemini Banana API","directories":{},"_nodeVersion":"20.19.6","dependencies":{"axios":"^1.7.9","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/gemini-image-mcp_1.1.1_1768539273657_0.1885780424169352","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@agentrix/gemini-image-mcp","version":"1.1.2","keywords":["mcp","gemini","image-generation","ai","banana"],"author":"","license":"MIT","_id":"@agentrix/gemini-image-mcp@1.1.2","maintainers":[{"name":"xmz.ai","email":"saizhuolin@gmail.com"}],"homepage":"https://github.com/xmz-ai/agentrix-mcp-tools#readme","bugs":{"url":"https://github.com/xmz-ai/agentrix-mcp-tools/issues"},"bin":{"gemini-image-mcp":"dist/index.js"},"dist":{"shasum":"b6c8596ba4ae0a065342cf97e24d42d04ead013b","tarball":"https://registry.npmjs.org/@agentrix/gemini-image-mcp/-/gemini-image-mcp-1.1.2.tgz","fileCount":9,"integrity":"sha512-n9gG/UCWCO6pva2VXkAoBPBAwIH6jyFy+SMfZLHFXSU/5ScSVd/i8B5x3AgBs515Rtfucqvgrh9ZlUYDbFPqpg==","signatures":[{"sig":"MEMCHyffg4vW39Z3gjflVxAq+SY/eZgeGLgpX0/rc/NzaBwCIFqdVmnQFMri81O+o2+X/WvPJrAIDCH5/Wa6N56cxhG5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentrix%2fgemini-image-mcp@1.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1415509},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"6606794521610816c5dd973fbaddce577fbb5395","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"xmz.ai","email":"saizhuolin@gmail.com"},"repository":{"url":"git+https://github.com/xmz-ai/agentrix-mcp-tools.git","type":"git","directory":"gemini-image-mcp"},"_npmVersion":"10.8.2","description":"MCP server for generating images using Gemini Banana API","directories":{},"_nodeVersion":"20.20.1","dependencies":{"axios":"^1.7.9","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/gemini-image-mcp_1.1.2_1773978397148_0.763229469122287","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"@agentrix/gemini-image-mcp","version":"1.1.3","keywords":["mcp","gemini","image-generation","ai","banana"],"author":"","license":"MIT","_id":"@agentrix/gemini-image-mcp@1.1.3","maintainers":[{"name":"xmz.ai","email":"saizhuolin@gmail.com"}],"homepage":"https://github.com/xmz-ai/agentrix-mcp-tools#readme","bugs":{"url":"https://github.com/xmz-ai/agentrix-mcp-tools/issues"},"bin":{"gemini-image-mcp":"dist/index.js"},"dist":{"shasum":"8d3efa1e6977a32bd926bbc75e73ead21ed4da18","tarball":"https://registry.npmjs.org/@agentrix/gemini-image-mcp/-/gemini-image-mcp-1.1.3.tgz","fileCount":9,"integrity":"sha512-/w/6qyNyF/vyKyk02bYHsK2DnljbY1KtP8jdToG2Rqm0kPp3kIoRRC2ZZS5qlWZ79J9DlOW2bI1n07mFINLTag==","signatures":[{"sig":"MEUCIQD+AGSrbQjaMHV5fGMwur0ggeYQ1MO8aTrNN3h1w3OOawIgZ9yoPcX0BsNo3q01GS+xNZ/hqYCvUyEv7Fq9Lk6Y+iA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentrix%2fgemini-image-mcp@1.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1415920},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"76fe1a345bb0d47aeeeb05d8c1273819cabba752","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepare":"npm run build"},"_npmUser":{"name":"xmz.ai","email":"saizhuolin@gmail.com"},"repository":{"url":"git+https://github.com/xmz-ai/agentrix-mcp-tools.git","type":"git","directory":"gemini-image-mcp"},"_npmVersion":"10.8.2","description":"MCP server for generating images using Gemini Banana API","directories":{},"_nodeVersion":"20.20.1","dependencies":{"axios":"^1.7.9","@modelcontextprotocol/sdk":"^0.6.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/gemini-image-mcp_1.1.3_1773991408710_0.9996859360745693","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"@agentrix/gemini-image-mcp","version":"1.1.4","description":"MCP server for generating images using Gemini Banana API","type":"module","main":"dist/index.js","bin":{"gemini-image-mcp":"dist/index.js"},"scripts":{"build":"tsc","prepare":"npm run build","start":"node dist/index.js","dev":"tsc --watch"},"keywords":["mcp","gemini","image-generation","ai","banana"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/xmz-ai/agentrix-mcp-tools.git","directory":"gemini-image-mcp"},"dependencies":{"@modelcontextprotocol/sdk":"^0.6.0","axios":"^1.7.9"},"devDependencies":{"@types/node":"^22.10.5","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"@agentrix/gemini-image-mcp@1.1.4","gitHead":"b880751acc79f24892d27ee8d37dc59035c9a788","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/xmz-ai/agentrix-mcp-tools/issues"},"homepage":"https://github.com/xmz-ai/agentrix-mcp-tools#readme","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-GQtNMUq/RTkLWrhydnMVS6gp40a7M/5OS8G0hJcuetpBPlU5cWT+FMCJMt9GOW7gQfbOnv6kwDyMTqTi7PRQFw==","shasum":"b19efd9eba2ed56a7aec306bc229ebb5c1d9ade2","tarball":"https://registry.npmjs.org/@agentrix/gemini-image-mcp/-/gemini-image-mcp-1.1.4.tgz","fileCount":9,"unpackedSize":1415947,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentrix%2fgemini-image-mcp@1.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHtm0dz+DW/hJSXEVh6mifNpAtbKoj/a/CWBIWW8MHD8AiADnyBxD/J+V035+6Ln0JYrl/iRRjDk1n+uqT7Q7de+Mg=="}]},"_npmUser":{"name":"xmz.ai","email":"saizhuolin@gmail.com"},"directories":{},"maintainers":[{"name":"xmz.ai","email":"saizhuolin@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gemini-image-mcp_1.1.4_1774001840335_0.3557321392040651"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-15T10:18:26.912Z","modified":"2026-03-20T10:17:20.917Z","1.1.0":"2026-01-15T10:18:27.263Z","1.1.1":"2026-01-16T04:54:33.839Z","1.1.2":"2026-03-20T03:46:37.401Z","1.1.3":"2026-03-20T07:23:28.959Z","1.1.4":"2026-03-20T10:17:20.621Z"},"bugs":{"url":"https://github.com/xmz-ai/agentrix-mcp-tools/issues"},"license":"MIT","homepage":"https://github.com/xmz-ai/agentrix-mcp-tools#readme","keywords":["mcp","gemini","image-generation","ai","banana"],"repository":{"type":"git","url":"git+https://github.com/xmz-ai/agentrix-mcp-tools.git","directory":"gemini-image-mcp"},"description":"MCP server for generating images using Gemini Banana API","maintainers":[{"name":"xmz.ai","email":"saizhuolin@gmail.com"}],"readme":"# Gemini Image MCP Server\n\nA Model Context Protocol (MCP) server that provides image generation capabilities using Google's Gemini Banana API.\n\n## Features\n\n- Generate images from text prompts using Gemini API\n- Support for different aspect ratios (1:1, 16:9, 9:16, 4:3, 3:4)\n- Negative prompts to avoid unwanted elements\n- Returns base64 encoded images compatible with MCP clients\n- Configurable API endpoint, key, and model\n\n## Installation\n\n### From npm (when published)\n\n```bash\nnpm install -g @agentrix/gemini-image-mcp\n```\n\n### From source\n\n```bash\ngit clone <repository-url>\ncd gemini-image-mcp\nnpm install\nnpm run build\n```\n\n## Configuration\n\nThe server requires environment variables for configuration. `AGENTRIX_*` prefixed variables take priority over their unprefixed counterparts:\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `AGENTRIX_GEMINI_API_KEY` | No* | - | Gemini API key (highest priority) |\n| `GEMINI_API_KEY` | No* | - | Gemini API key (fallback) |\n| `AGENTRIX_GEMINI_BASE_URL` | No | `https://generativelanguage.googleapis.com/v1beta` | Gemini API base URL (highest priority) |\n| `GEMINI_BASE_URL` | No | `https://generativelanguage.googleapis.com/v1beta` | Gemini API base URL (fallback) |\n| `AGENTRIX_GEMINI_IMAGE_MODEL` | No | `gemini-2.5-flash-image` | Image generation model |\n\n\\* At least one of `AGENTRIX_GEMINI_API_KEY` or `GEMINI_API_KEY` is required.\n\n## Usage\n\n### With Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-image\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentrix/gemini-image-mcp\"],\n      \"env\": {\n        \"AGENTRIX_GEMINI_API_KEY\": \"your-api-key-here\",\n        \"AGENTRIX_GEMINI_BASE_URL\": \"https://generativelanguage.googleapis.com/v1beta\",\n        \"AGENTRIX_GEMINI_IMAGE_MODEL\": \"gemini-2.5-flash-image\"\n      }\n    }\n  }\n}\n```\n\nOr if installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"gemini-image\": {\n      \"command\": \"gemini-image-mcp\",\n      \"env\": {\n        \"AGENTRIX_GEMINI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Standalone\n\n```bash\nexport AGENTRIX_GEMINI_API_KEY=\"your-api-key-here\"\nexport AGENTRIX_GEMINI_BASE_URL=\"https://generativelanguage.googleapis.com/v1beta\"\nexport AGENTRIX_GEMINI_IMAGE_MODEL=\"gemini-2.5-flash-image\"\n\ngemini-image-mcp\n```\n\n## Available Tools\n\n### generate_image\n\nGenerate an image from a text prompt. Can return base64 encoded images or save them to disk.\n\n**Parameters:**\n\n- `prompt` (string, required): The text description of the image to generate\n- `aspectRatio` (string, optional): The aspect ratio of the image. Options: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\". Default: \"1:1\"\n- `negativePrompt` (string, optional): Description of elements to avoid in the image\n- `path` (string, optional): Directory path to save generated images. If provided, all images will be saved as PNG files instead of returning base64 data\n\n**Returns:**\n\nWhen `path` is NOT provided:\n- Text confirmation message\n- Base64 encoded image data with MIME type (for all generated images)\n\nWhen `path` is provided:\n- Text message with list of saved file paths\n\n**Note:** The API may generate multiple images per request. All images will be either returned as base64 data or saved to the specified directory.\n\n**Example 1: Return base64 data**\n\n```javascript\n{\n  \"name\": \"generate_image\",\n  \"arguments\": {\n    \"prompt\": \"A serene mountain landscape at sunset with a lake reflection\",\n    \"aspectRatio\": \"16:9\",\n    \"negativePrompt\": \"people, buildings, text\"\n  }\n}\n```\n\n**Example 2: Save to disk**\n\n```javascript\n{\n  \"name\": \"generate_image\",\n  \"arguments\": {\n    \"prompt\": \"A cute cat sitting on a sofa\",\n    \"path\": \"/Users/username/images\"\n  }\n}\n```\n\nResponse:\n```\nSuccessfully generated 2 images for prompt: \"A cute cat sitting on a sofa\"\n\nImages saved to:\n- /Users/username/images/image_1737023456789_1.png\n- /Users/username/images/image_1737023456789_2.png\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Watch mode for development\nnpm run dev\n\n# Run locally\nnpm start\n```\n\n## Publishing\n\nTo publish to npm:\n\n1. Update version in `package.json`\n2. Build the project: `npm run build`\n3. Login to npm: `npm login`\n4. Publish: `npm publish --access public`\n\n## Requirements\n\n- Node.js >= 18.0.0\n- Valid Gemini API key with image generation access\n\n## Error Handling\n\nThe server provides detailed error messages for common issues:\n\n- Missing API key\n- API request failures\n- Invalid responses\n- Network timeouts (60 second timeout per request)\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nFor issues and questions, please open an issue on the GitHub repository.\n","readmeFilename":"README.md"}