{"_id":"@chadneal/gimage-mcp","_rev":"5-a1824ef1184576f9b0733eb49bb6de55","name":"@chadneal/gimage-mcp","dist-tags":{"latest":"1.1.14"},"versions":{"0.1.0":{"name":"@chadneal/gimage-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","ai","image-generation","image-processing","gemini","vertex-ai","image-resize","image-conversion"],"author":{"name":"Chad Neal","email":"chad@chadneal.com"},"license":"MIT","_id":"@chadneal/gimage-mcp@0.1.0","maintainers":[{"name":"chadneal","email":"chad.neal@gmail.com"}],"homepage":"https://github.com/chadneal/gimage#readme","bugs":{"url":"https://github.com/chadneal/gimage/issues"},"os":["darwin","linux","win32"],"bin":{"gimage-mcp":"bin/gimage-mcp.js"},"cpu":["x64","arm64"],"dist":{"shasum":"660334cae5d32480e806e774f60100cbf49fc37f","tarball":"https://registry.npmjs.org/@chadneal/gimage-mcp/-/gimage-mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-2ek/i5E4S94jJ8XobfM/DUobmcx6yCJRGPCtUscAVyuAZgb8IsCUPSw2mc1reexctKUUI5AeFBN84Kr5eZnwcw==","signatures":[{"sig":"MEYCIQCYP3o3WOD+7ovMsGHs2FALRA73pxl0xOiYmueewnCQtgIhALlKG6FGGBpfgkG76Ugy1gXxOV0hJXNx9YpRImN6Pa9i","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11710},"engines":{"node":">=18.0.0"},"gitHead":"98b0567f470354e4b6315fec77d75edc97ada32b","scripts":{"postinstall":"node scripts/install.js"},"_npmUser":{"name":"chadneal","email":"chad.neal@gmail.com"},"repository":{"url":"git+https://github.com/chadneal/gimage.git","type":"git","directory":"npm"},"_npmVersion":"11.6.2","description":"MCP server for AI-powered image generation and processing with gimage","directories":{},"_nodeVersion":"22.18.0","dependencies":{"tar":"^7.0.0"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/gimage-mcp_0.1.0_1762013452874_0.6758716120661672","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package has moved to @apresai/gimage-mcp. Please update your dependencies."},"1.1.12":{"name":"@chadneal/gimage-mcp","version":"1.1.12","keywords":["mcp","model-context-protocol","claude","ai","image-generation","image-processing","gemini","vertex-ai","image-resize","image-conversion"],"author":{"name":"Chad Neal","email":"chad@chadneal.com"},"license":"MIT","_id":"@chadneal/gimage-mcp@1.1.12","maintainers":[{"name":"chadneal","email":"chad.neal@gmail.com"}],"homepage":"https://github.com/chadneal/gimage#readme","bugs":{"url":"https://github.com/chadneal/gimage/issues"},"os":["darwin","linux","win32"],"bin":{"gimage-mcp":"bin/gimage-mcp.js"},"cpu":["x64","arm64"],"dist":{"shasum":"529aa168c3aa304b4a2af73e1acd7f74066a8841","tarball":"https://registry.npmjs.org/@chadneal/gimage-mcp/-/gimage-mcp-1.1.12.tgz","fileCount":4,"integrity":"sha512-2AuWAs3xjQlHaGLAuBDiokFvHfl4BqOT1HwSPry3/eptBzUFCH7mmiaIMPCZ99vgwVm22+cBc2sNGQwp5k/KZg==","signatures":[{"sig":"MEUCIGXKEx8F1w9OkK/LEpNQlmxJ/Wwr4sCooyQ0BqEaF3ueAiEAynGv9eVynVDWJFMT2niJWltAD2tKbPId9fNmPqHg8V0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11711},"engines":{"node":">=18.0.0"},"gitHead":"98b0567f470354e4b6315fec77d75edc97ada32b","scripts":{"postinstall":"node scripts/install.js"},"_npmUser":{"name":"chadneal","email":"chad.neal@gmail.com"},"repository":{"url":"git+https://github.com/chadneal/gimage.git","type":"git","directory":"npm"},"_npmVersion":"11.6.2","description":"MCP server for AI-powered image generation and processing with gimage","directories":{},"_nodeVersion":"22.18.0","dependencies":{"tar":"^7.0.0"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/gimage-mcp_1.1.12_1762013500273_0.5645438110761605","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package has moved to @apresai/gimage-mcp. Please update your dependencies."},"1.1.13":{"name":"@chadneal/gimage-mcp","version":"1.1.13","keywords":["mcp","model-context-protocol","claude","ai","image-generation","image-processing","gemini","vertex-ai","image-resize","image-conversion"],"author":{"name":"Chad Neal","email":"chad@chadneal.com"},"license":"MIT","_id":"@chadneal/gimage-mcp@1.1.13","maintainers":[{"name":"chadneal","email":"chad.neal@gmail.com"}],"homepage":"https://github.com/chadneal/gimage#readme","bugs":{"url":"https://github.com/chadneal/gimage/issues"},"os":["darwin","linux","win32"],"bin":{"gimage-mcp":"bin/gimage-mcp.js"},"cpu":["x64","arm64"],"dist":{"shasum":"163be276436f51b51cc708308b45f0cd8210685b","tarball":"https://registry.npmjs.org/@chadneal/gimage-mcp/-/gimage-mcp-1.1.13.tgz","fileCount":4,"integrity":"sha512-a2+EA9dnvuhRehddQ1TlohrtdkLqdW5R9PVgAXP64g5UzCP/gGb20ebetb1xlf8L48wWwObsmABrqVI56fH4IQ==","signatures":[{"sig":"MEQCIHHLqYb1C+WX91XKO9U02arS6p+pf5+ZpzbPnMXKDi2IAiB5/Ws9y7c214gX+DIy1JIvwvP4B7+z/Y4LRnY3IbXyHg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12032},"engines":{"node":">=18.0.0"},"gitHead":"35432a25306f34dba7356b0867fd118c79080181","scripts":{"postinstall":"node scripts/install.js"},"_npmUser":{"name":"chadneal","email":"chad.neal@gmail.com"},"repository":{"url":"git+https://github.com/chadneal/gimage.git","type":"git","directory":"npm"},"_npmVersion":"11.6.2","description":"MCP server for AI-powered image generation and processing with gimage","directories":{},"_nodeVersion":"22.18.0","dependencies":{"tar":"^7.0.0"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/gimage-mcp_1.1.13_1762013988717_0.6016192018159863","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package has moved to @apresai/gimage-mcp. Please update your dependencies."},"1.1.14":{"name":"@chadneal/gimage-mcp","version":"1.1.14","keywords":["mcp","model-context-protocol","claude","ai","image-generation","image-processing","gemini","vertex-ai","image-resize","image-conversion"],"author":{"name":"Chad Neal","email":"chad@chadneal.com"},"license":"MIT","_id":"@chadneal/gimage-mcp@1.1.14","maintainers":[{"name":"chadneal","email":"chad.neal@gmail.com"}],"homepage":"https://github.com/chadneal/gimage#readme","bugs":{"url":"https://github.com/chadneal/gimage/issues"},"os":["darwin","linux","win32"],"bin":{"gimage-mcp":"bin/gimage-mcp.js"},"cpu":["x64","arm64"],"dist":{"shasum":"caa36684b6cd94406dea276e830b90e5b6c1cab1","tarball":"https://registry.npmjs.org/@chadneal/gimage-mcp/-/gimage-mcp-1.1.14.tgz","fileCount":4,"integrity":"sha512-mVV8+qDJsVAjN6em1KwvXwV7DAnAGKjL1qPFnSSJ9MkIVZ3D6TUhh6d3SEbk+9A6i6DXm2CvEHO+SXukKz1fVQ==","signatures":[{"sig":"MEUCICQAztO3xtt80nEndmK9IXxd94YTq5l4B5hU6hLFeC7EAiEAh8DZ0ZPcsynxnTatFHH+/RgjWaVRIcANfPQqCEofPVY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12032},"engines":{"node":">=18.0.0"},"gitHead":"35432a25306f34dba7356b0867fd118c79080181","scripts":{"postinstall":"node scripts/install.js"},"_npmUser":{"name":"chadneal","email":"chad.neal@gmail.com"},"repository":{"url":"git+https://github.com/chadneal/gimage.git","type":"git","directory":"npm"},"_npmVersion":"11.6.2","description":"MCP server for AI-powered image generation and processing with gimage","directories":{},"_nodeVersion":"22.18.0","dependencies":{"tar":"^7.0.0"},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/gimage-mcp_1.1.14_1762014060964_0.20435364258480893","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package has moved to @apresai/gimage-mcp. Please update your dependencies."}},"time":{"created":"2025-11-01T16:10:52.763Z","modified":"2025-11-02T14:22:48.750Z","0.1.0":"2025-11-01T16:10:53.057Z","1.1.12":"2025-11-01T16:11:40.461Z","1.1.13":"2025-11-01T16:19:48.964Z","1.1.14":"2025-11-01T16:21:01.195Z"},"bugs":{"url":"https://github.com/chadneal/gimage/issues"},"author":{"name":"Chad Neal","email":"chad@chadneal.com"},"license":"MIT","homepage":"https://github.com/chadneal/gimage#readme","keywords":["mcp","model-context-protocol","claude","ai","image-generation","image-processing","gemini","vertex-ai","image-resize","image-conversion"],"repository":{"url":"git+https://github.com/chadneal/gimage.git","type":"git","directory":"npm"},"description":"MCP server for AI-powered image generation and processing with gimage","maintainers":[{"name":"chadneal","email":"chad.neal@gmail.com"}],"readme":"# @chadneal/gimage-mcp\n\nMCP (Model Context Protocol) server for AI-powered image generation and processing with gimage.\n\n## Quick Start\n\n### Installation\n\n```bash\nnpm install -g @chadneal/gimage-mcp\n```\n\nOr use without installation:\n\n```bash\nnpx @chadneal/gimage-mcp\n```\n\n### Configure Claude Desktop\n\nAdd to your Claude Desktop MCP configuration file:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Linux**: `~/.config/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"gimage\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@chadneal/gimage-mcp\"]\n    }\n  }\n}\n```\n\n### Setup Authentication\n\nBefore using, configure your Gemini API key:\n\n```bash\ngimage auth gemini\n```\n\nGet your free API key from: https://aistudio.google.com/app/apikey\n\n### Restart Claude Desktop\n\nQuit and reopen Claude Desktop to load the MCP server.\n\n## Features\n\nThe MCP server provides 10 tools for AI assistants:\n\n### Image Generation\n- **generate_image** - Create AI images from text prompts\n  - Multiple models: Gemini 2.5 Flash, Imagen 3, Imagen 4\n  - Sizes up to 2048x2048\n  - Style controls (photorealistic, artistic, anime)\n  - Negative prompts\n  - Reproducible generation with seeds\n\n### Image Processing\n- **resize_image** - Resize to specific dimensions\n- **scale_image** - Scale by factor (maintain aspect ratio)\n- **crop_image** - Crop to specific region\n- **compress_image** - Reduce file size with quality control\n- **convert_image** - Convert between formats (PNG, JPG, WebP, GIF, TIFF, BMP)\n\n### Batch Operations\n- **batch_resize** - Resize multiple images concurrently\n- **batch_compress** - Compress multiple images\n- **batch_convert** - Convert multiple images to new format\n\n### Utilities\n- **list_models** - List available AI models with details\n\n## Usage Examples\n\nOnce installed and configured, you can use natural language in Claude:\n\n**Image Generation**:\n- \"Generate an image of a sunset over mountains\"\n- \"Create a photorealistic portrait of a wise old wizard\"\n- \"Generate an anime-style image of cherry blossoms\"\n\n**Image Processing**:\n- \"Resize photo.jpg to 800x600\"\n- \"Compress all images in the photos directory to 85% quality\"\n- \"Convert image.png to WebP format\"\n\n**Batch Operations**:\n- \"Resize all images in the vacation-photos folder to 1920x1080\"\n- \"Compress all PNG files to reduce storage space\"\n- \"Convert all photos to WebP for web use\"\n\n## Requirements\n\n- Node.js 18.0.0 or higher\n- Gemini API key (free tier available) or Vertex AI access\n\n## Supported Platforms\n\n- macOS (Intel & Apple Silicon)\n- Linux (x86_64 & ARM64)\n- Windows (x86_64)\n\n## Environment Variables\n\nThe server respects these environment variables:\n\n- `GEMINI_API_KEY` - Gemini API key for image generation\n- `VERTEX_API_KEY` - Vertex AI API key (Express Mode)\n- `VERTEX_PROJECT` - GCP project ID for Vertex AI\n- `VERTEX_LOCATION` - Vertex AI location (default: us-central1)\n- `GOOGLE_APPLICATION_CREDENTIALS` - Path to service account JSON\n\n## Troubleshooting\n\n### Server not connecting\n\n1. Verify gimage is installed:\n   ```bash\n   which gimage\n   ```\n\n2. Test manually:\n   ```bash\n   gimage serve\n   ```\n\n3. Check Claude Desktop logs\n\n### Image generation fails\n\n1. Verify API key is configured:\n   ```bash\n   gimage auth gemini\n   ```\n\n2. Test generation manually:\n   ```bash\n   gimage generate \"test image\"\n   ```\n\n## Alternative Installation Methods\n\n### Homebrew (macOS/Linux)\n\n```bash\nbrew install chadneal/tap/gimage\n```\n\nThen configure Claude Desktop with:\n\n```json\n{\n  \"mcpServers\": {\n    \"gimage\": {\n      \"command\": \"gimage\",\n      \"args\": [\"serve\"]\n    }\n  }\n}\n```\n\n### Manual Binary Download\n\nDownload from: https://github.com/chadneal/gimage/releases\n\n## Documentation\n\n- [Complete MCP Tools Reference](https://github.com/chadneal/gimage/blob/main/docs/MCP_TOOLS.md)\n- [Usage Guide](https://github.com/chadneal/gimage/blob/main/docs/MCP_USAGE.md)\n- [Examples](https://github.com/chadneal/gimage/blob/main/docs/MCP_EXAMPLES.md)\n- [Main Documentation](https://github.com/chadneal/gimage)\n\n## License\n\nMIT\n\n## Support\n\n- GitHub Issues: https://github.com/chadneal/gimage/issues\n- Documentation: https://github.com/chadneal/gimage#readme\n","readmeFilename":"README.md"}