[{"_1":2,"_328":-5,"_329":-5},"loaderData",{"_3":4,"_22":23,"_238":239},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",16246667,"membership","referenceId","01996c17-eef2-7208-aa1b-bc546c003f59","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_156":157,"_236":237},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Enables conversational image generation and editing with Google's Gemini 2.5 Flash Image Preview. Supports text-to-image generation, natural language image editing, multi-image composition, and style transfer with optional file saving.","name","Gemini 2.5 Flash Image MCP","readme","# Gemini 2.5 Flash Image MCP\n\nA Model Context Protocol (MCP) server for conversational image generation and editing with Google's Gemini 2.5 Flash Image Preview. Designed to be easy to install and use from Claude Code and other MCP clients.\n\n## Key Features\n\n- **Text-to-Image**: Generate images from detailed prompts\n- **Image Editing**: Edit images with natural language instructions\n- **Multi-Image Composition / Style Transfer**: Combine images or transfer styles\n- **File Save Option**: Return base64 image and optionally save to file\n- **Provider-Agnostic MCP**: Works in any MCP-enabled client\n\n## Requirements\n\n- Node.js 18 or newer\n- An MCP client (Claude Code, Cursor, VS Code, Windsurf, etc.)\n- Google Gemini API Key: set `GEMINI_API_KEY`\n\n### Get a Gemini API key\n\nFollow these steps to obtain an API key from Google AI Studio:\n\n1) Open Google AI Studio and sign in: https://aistudio.google.com/apikey\n2) Click “Create API key” (or “Manage keys” if you already have one)\n3) Copy the generated key\n4) Set it as an environment variable on your machine when running this server\n\nExamples:\n```bash\n# macOS / Linux (bash/zsh)\nexport GEMINI_API_KEY=\"YOUR_API_KEY\"\n\n# Windows PowerShell\n$env:GEMINI_API_KEY=\"YOUR_API_KEY\"\n```\n\n## Getting Started\n\nFirst, install the MCP server with your client. The following examples center on Claude Code usage.\n\n**Standard config** works in most tools:\n\n```json\n{\n \"mcpServers\": {\n \"gemini-2-5-flash-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"@taiyokimura/gemini-2-5-flash-mcp@latest\"]\n }\n }\n}\n```\n\n### Quick usage (Claude Code)\n\n```bash\n# npx（非対話フラグ付き） + APIキー同時指定（Claudeの -e 指定）\nclaude mcp add gemini-2-5-flash-mcp -s user -e GEMINI_API_KEY=\"YOUR_API_KEY\" -- npx -y @taiyokimura/gemini-2-5-flash-mcp@latest\n\n# グローバルインストール + APIキー同時指定（Claudeの -e 指定）\nnpm i -g @taiyokimura/gemini-2-5-flash-mcp \\\n && claude mcp add gemini-2-5-flash-mcp -s user -e GEMINI_API_KEY=\"YOUR_API_KEY\" -- gemini-2-5-flash-mcp\n\n# HTTP モードで登録（SSE既定）例（対応クライアントのみ）\n# ※ HTTP モードはこのプロセス自体がHTTPサーバとして常駐します\nclaude mcp add gemini-2-5-flash-mcp -s user \\\n -e GEMINI_API_KEY=\"YOUR_API_KEY\" \\\n -e MCP_TRANSPORT=\"http\" \\\n -e MCP_HTTP_PORT=\"7801\" \\\n -e MCP_HTTP_PATH=\"/mcp\" \\\n -- npx -y @taiyokimura/gemini-2-5-flash-mcp@latest\n```\n\n### Streamable HTTP mode（実験的）\n\nSTDIO の代わりに Streamable HTTP を使うこともできます。MCP クライアントが Streamable HTTP に対応している場合のみ利用してください。\n\n1) サーバーを HTTP モードで起動\n\n```bash\nexport MCP_TRANSPORT=http\nexport GEMINI_API_KEY=YOUR_API_KEY\n# 任意（既定: 7801, /mcp, SSE）\nexport MCP_HTTP_PORT=7801\nexport MCP_HTTP_PATH=/mcp\nexport MCP_HTTP_ENABLE_JSON=false\n\nnpm run build\nnode ./build/index.js\n# => HTTP transport listening on http://localhost:7801/mcp\n```\n\n2) クライアント側設定（例: Streamable HTTP対応クライアント）\n\n- Type: HTTP (Streamable)\n- URL: `http://localhost:7801/mcp`\n\n注:\n- SSE ストリーミングが既定。JSONレスポンスで使いたい場合は `MCP_HTTP_ENABLE_JSON=true`。\n- セッションはサーバー側で生成（stateful）。完全 stateless にしたい場合はコード側で `sessionIdGenerator: undefined` に変更可能です。\n\n

Claude Code (Recommended)

\n\nUse the Claude Code CLI to add the MCP server:\n\n```bash\nclaude mcp add gemini-2-5-flash-mcp -s user -- npx @taiyokimura/gemini-2-5-flash-mcp@latest\n```\n\nRemove if needed:\n```bash\nclaude mcp remove gemini-2-5-flash-mcp\n```\n

\n\n

Claude Desktop

\n\nFollow the MCP install guide and use the standard config above.\n\n- Guide: https://modelcontextprotocol.io/quickstart/user\n

\n\n

Cursor

\n\nGo to `Cursor Settings` → `MCP` → `Add new MCP Server`.\n\nUse the following:\n- Name: gemini-2-5-flash-mcp\n- Type: command\n- Command: npx\n- Args: @taiyokimura/gemini-2-5-flash-mcp@latest\n- Auto start: on (optional)\n

\n\n

VS Code

\n\nAdd via CLI:\n\n```bash\ncode --add-mcp '{\"name\":\"gemini-2-5-flash-mcp\",\"command\":\"npx\",\"args\":[\"@taiyokimura/gemini-2-5-flash-mcp@latest\"]}'\n```\n\nOr use the standard config in settings.\n

\n\n

LM Studio

\n\nAdd MCP Server with:\n- Command: npx\n- Args: [\"@taiyokimura/gemini-2-5-flash-mcp@latest\"]\n

\n\n

Goose

\n\nAdvanced settings → Extensions → Add custom extension:\n- Type: STDIO\n- Command: npx\n- Args: @taiyokimura/gemini-2-5-flash-mcp@latest\n- Enabled: true\n

\n\n

opencode

\n\nExample `~/.config/opencode/opencode.json`:\n\n```json\n{\n \"$schema\": \"https://opencode.ai/config.json\",\n \"mcp\": {\n \"gemini-2-5-flash-mcp\": {\n \"type\": \"local\",\n \"command\": [\n \"npx\",\n \"@taiyokimura/gemini-2-5-flash-mcp@latest\"\n ],\n \"enabled\": true\n }\n }\n}\n```\n

\n\n

Qodo Gen

\n\nOpen Qodo Gen → Connect more tools → + Add new MCP → Paste the standard config above → Save.\n

\n\n

Windsurf

\n\nFollow Windsurf MCP documentation and use the standard config above.\n- Docs: https://docs.windsurf.com/windsurf/cascade/mcp\n

\n\n## Environment Variables\n\n- `GEMINI_API_KEY` (required)\n- `GEMINI_IMAGE_ENDPOINT` (optional) default:\n `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-image-preview:generateContent`\n- `MCP_NAME` (optional, default: `gemini-2-5-flash-mcp`)\n\n## Available Tools\n\n### 1. generate_image\nGenerate an image from a text prompt.\n\nParameters:\n- `prompt` (required): Detailed description to generate\n- `saveToFilePath` (optional): Path to save the image\n\nExample input:\n```json\n{\n \"prompt\": \"Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme\",\n \"saveToFilePath\": \"./gemini-native-image.png\"\n}\n```\n\n### 2. edit_image\nEdit an image using a prompt.\n\nParameters:\n- `prompt` (required): Edit instruction\n- `image` (required): `{ dataBase64?: string, path?: string, mimeType?: string }`\n- `saveToFilePath` (optional)\n\nExample input:\n```json\n{\n \"prompt\": \"Add a small, knitted wizard hat to the cat\",\n \"image\": { \"path\": \"./cat.jpeg\", \"mimeType\": \"image/jpeg\" },\n \"saveToFilePath\": \"./gemini-edited-image.png\"\n}\n```\n\n### 3. compose_images\nCombine elements from multiple images.\n\nParameters:\n- `prompt` (required)\n- `images` (required): Array of image inputs (2-3 recommended)\n- `saveToFilePath` (optional)\n\n### 4. style_transfer\nTransfer the style of one image to another.\n\nParameters:\n- `prompt` (optional)\n- `baseImage` (required)\n- `styleImage` (required)\n- `saveToFilePath` (optional)\n\n## Development\n\nRun locally:\n\n```bash\nnpm install\nnpm run build\nnpx .\n```\n\n## Name Consistency & Troubleshooting\n\n- Always use CANONICAL_ID (`gemini-2-5-flash-mcp`) for identifiers and keys.\n- Use CANONICAL_DISPLAY (`Gemini 2.5 Flash MCP`) only for UI labels.\n- Do not mix different names across clients.\n\nConsistency Matrix:\n- npm package name → `gemini-2-5-flash-mcp`\n- Binary name → `gemini-2-5-flash-mcp`\n- MCP server name (SDK metadata) → `gemini-2-5-flash-mcp`\n- Env default MCP_NAME → `gemini-2-5-flash-mcp`\n- Client registry key → `gemini-2-5-flash-mcp`\n- UI label → `Gemini 2.5 Flash MCP`\n\nConflict Cleanup:\n- Remove any old entries like \"GeminiFlash\" and re-add with `gemini-2-5-flash-mcp`.\n- Ensure global registries only use `gemini-2-5-flash-mcp` for keys.\n- Cursor: configure in the UI only. This project does not include `.cursor/mcp.json`.\n\n## References\n\n- MCP SDK: https://modelcontextprotocol.io/docs/sdks\n- Architecture: https://modelcontextprotocol.io/docs/learn/architecture\n- Server concepts: https://modelcontextprotocol.io/docs/learn/server-concepts\n- Server spec (2025-06-18): https://modelcontextprotocol.io/specification/2025-06-18/server/index\n- Gemini image generation: https://ai.google.dev/gemini-api/docs/image-generation\n\n","English","tag","en-US",{"_41":42,"_13":43,"_50":32,"_51":32,"_16":52,"_53":54,"_33":34,"_66":67,"_74":-5,"_75":76,"_145":146,"_150":-5,"_61":128,"_151":152,"_64":153,"_154":155},"addedAt","2025-09-02T06:11:13.661869Z",[44,45,46,47,48,49],"category:image-and-video-processing","category:multimedia-processing","environment:network","hosting:hybrid","language:javascript","license_grade:f","descriptionMarkdown","descriptionPlainText",11087,"integrations",[55],{"_56":57,"_31":63,"_64":65},"brand",{"_58":59,"_33":60,"_61":62},"logoSvgPath","M11.04 19.32Q12 21.51 12 24q0-2.49.93-4.68.96-2.19 2.58-3.81t3.81-2.55Q21.51 12 24 12q-2.49 0-4.68-.93a12.3 12.3 0 0 1-3.81-2.58 12.3 12.3 0 0 1-2.58-3.81Q12 2.49 12 0q0 2.49-.96 4.68-.93 2.19-2.55 3.81a12.3 12.3 0 0 1-3.81 2.58Q2.49 12 0 12q2.49 0 4.68.96 2.19.93 3.81 2.55t2.55 3.81","Google Gemini","slug","google-gemini","Provides conversational image generation and editing capabilities using Google's Gemini 2.5 Flash Image Preview model, including text-to-image generation, image editing with natural language instructions, multi-image composition, and style transfer","uid","h5jkwy62w3","namespace",{"_68":69,"_61":73},"owner",{"_70":71},"githubAccount",{"_72":73},"login","nanameru","redditPostExternalId","repository",{"_77":78,"_113":114,"_117":118,"_136":-5,"_137":138,"_139":140,"_144":-5},"argumentsJsonSchema",{"_79":80,"_110":111,"_86":112},"properties",{"_81":82,"_88":89,"_92":93,"_96":97,"_99":100,"_102":103,"_106":107},"MCP_NAME",{"_83":84,"_31":85,"_86":87},"default","gemini-2-5-flash-mcp","Name for the MCP server (optional)","type","string","MCP_HTTP_PATH",{"_83":90,"_31":91,"_86":87},"/mcp","Path for HTTP transport mode","MCP_HTTP_PORT",{"_83":94,"_31":95,"_86":87},"7801","Port for HTTP transport mode","MCP_TRANSPORT",{"_31":98,"_86":87},"Transport mode for MCP (http for HTTP mode, otherwise STDIO)","GEMINI_API_KEY",{"_31":101,"_86":87},"Google Gemini API key (required)","MCP_HTTP_ENABLE_JSON",{"_83":104,"_31":105,"_86":87},"false","Enable JSON responses instead of SSE streaming for HTTP mode","GEMINI_IMAGE_ENDPOINT",{"_83":108,"_31":109,"_86":87},"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-image-preview:generateContent","Gemini image generation endpoint URL (optional)","required",[99],"object","githubProject",{"_35":36,"_115":116},"url","https://github.com/nanameru/gemini-2.5-flash-image-mcp","githubRepository",{"_119":120,"_121":122,"_123":124,"_16":125,"_126":127,"_33":128,"_68":129,"_131":132,"_133":-5,"_134":135},"defaultBranch","main","fullName","nanameru/Gemini-2.5-Flash-Image-MCP","githubTreeId",349598,25290,"language","JavaScript","Gemini-2.5-Flash-Image-MCP",{"_72":73,"_64":130},"tluemsu8v0","recentStargazers",0,"spdxLicense","stargazers",1,"glamaJson","inspectable",true,"npmPackage",{"_33":141,"_142":143},"@taiyokimura/gemini-2-5-flash-mcp","weeklyDownloads",15,"supportedPlatforms","scores",{"_147":132,"_148":-5,"_149":-5},"license","quality","security","simpleIcon","toolCount",4,"6wqckk0pkb","updatedAt","2025-09-23T06:25:52.921859Z","meta",[158,161,163,170,173,175,178,181,184,187,190,192,195,198,200,202,204,206,208],{"_159":160},"title","Gemini 2.5 Flash Image MCP | Glama",{"_162":32,"_33":31},"content",{"_164":165,"_166":167,"_168":169},"href","https://glama.ai/mcp/servers/@nanameru/Gemini-2.5-Flash-Image-MCP","rel","canonical","tagName","link",{"_162":34,"_171":172},"property","og:title",{"_162":32,"_171":174},"og:description",{"_162":176,"_171":177},"https://glama.ai/logo.png","og:logo",{"_162":179,"_171":180},"https://glama.ai/mcp/servers/@nanameru/Gemini-2.5-Flash-Image-MCP/og-image","og:image",{"_162":182,"_171":183},"630","og:image:height",{"_162":185,"_171":186},"1200","og:image:width",{"_162":188,"_171":189},"website","og:type",{"_162":165,"_171":191},"og:url",{"_162":193,"_171":194},"Glama – MCP Hosting Platform","og:site_name",{"_162":196,"_33":197},"summary_large_image","twitter:card",{"_162":193,"_33":199},"twitter:title",{"_162":32,"_33":201},"twitter:description",{"_162":179,"_33":203},"twitter:image",{"_162":182,"_33":205},"twitter:image:height",{"_162":185,"_33":207},"twitter:image:width",{"_209":210},"script:ld+json",{"_211":212,"_213":214},"@context","http://schema.org","@graph",[215],{"_211":216,"_217":218,"_219":220},"https://schema.org","@type","BreadcrumbList","itemListElement",[221,227,230,234],{"_217":222,"_223":224,"_33":225,"_226":135},"ListItem","item","/","Glama","position",{"_217":222,"_223":90,"_33":228,"_226":229},"MCP",2,{"_217":222,"_223":231,"_33":232,"_226":233},"/mcp/servers","Servers",3,{"_217":222,"_223":235,"_33":34,"_226":152},"/mcp/servers/@nanameru/Gemini-2.5-Flash-Image-MCP","visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_240":241,"_29":247,"_271":272,"_156":283,"_281":307,"_308":309},"blob",{"_162":242,"_243":244,"_245":246},"# Node modules and build artifacts\nnode_modules/\nbuild/\ndist/\n\n# Env files\n.env\n.env.*\n\n# OS/editor noise\n.DS_Store\n*.log\n*.tgz\ncoverage/\ntmp/\n/.idea/\n/.vscode/\n\n\n","fileName",".gitignore","size",163,{"_41":42,"_13":248,"_50":32,"_51":32,"_16":52,"_53":249,"_33":34,"_66":252,"_74":-5,"_75":255,"_145":270,"_150":-5,"_61":128,"_151":152,"_64":153,"_154":155},[44,45,46,47,48,49],[250],{"_56":251,"_31":63,"_64":65},{"_58":59,"_33":60,"_61":62},{"_68":253,"_61":73},{"_70":254},{"_72":73},{"_77":256,"_113":266,"_117":267,"_136":-5,"_137":138,"_139":269,"_144":-5},{"_79":257,"_110":265,"_86":112},{"_81":258,"_88":259,"_92":260,"_96":261,"_99":262,"_102":263,"_106":264},{"_83":84,"_31":85,"_86":87},{"_83":90,"_31":91,"_86":87},{"_83":94,"_31":95,"_86":87},{"_31":98,"_86":87},{"_31":101,"_86":87},{"_83":104,"_31":105,"_86":87},{"_83":108,"_31":109,"_86":87},[99],{"_35":36,"_115":116},{"_119":120,"_121":122,"_123":124,"_16":125,"_126":127,"_33":128,"_68":268,"_131":132,"_133":-5,"_134":135},{"_72":73,"_64":130},{"_33":141,"_142":143},{"_147":132,"_148":-5,"_149":-5},"member",{"_273":274,"_277":278,"_279":244,"_123":124,"_280":-5,"_281":244,"_282":138,"_245":246,"_86":240},"commit",{"_275":276},"sha","67066b748e1c3df7c54e02f6efda66ebed355e3b","contentStoredObjectPointerId",638716,"fullPath","indexable","path","safeToDisplayAsText",[284,286,288,290,292,293,294,296,297,298,299,300,301,302,303,304,305,306],{"_159":285},".gitignore | Gemini 2.5 Flash Image MCP | Glama",{"_162":287,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_164":289,"_166":167,"_168":169},"https://glama.ai/mcp/servers/@nanameru/Gemini-2.5-Flash-Image-MCP/blob/67066b748e1c3df7c54e02f6efda66ebed355e3b/",{"_162":291,"_171":172},".gitignore | Gemini 2.5 Flash Image MCP",{"_162":287,"_171":174},{"_162":176,"_171":177},{"_162":295,"_171":180},"https://glama.ai/generated-images/og?title=.gitignore+%7C+Gemini+2.5+Flash+Image+MCP",{"_162":182,"_171":183},{"_162":185,"_171":186},{"_162":188,"_171":189},{"_162":289,"_171":191},{"_162":193,"_171":194},{"_162":196,"_33":197},{"_162":193,"_33":199},{"_162":287,"_33":201},{"_162":295,"_33":203},{"_162":182,"_33":205},{"_162":185,"_33":207},"","treeMembers",[310,314,316,319,322,325],{"_273":311,"_279":312,"_281":312,"_86":313},{"_275":276},"src","tree",{"_273":315,"_279":244,"_281":244,"_86":240},{"_275":276},{"_273":317,"_279":318,"_281":318,"_86":240},{"_275":276},"package.json",{"_273":320,"_279":321,"_281":321,"_86":240},{"_275":276},"package-lock.json",{"_273":323,"_279":324,"_281":324,"_86":240},{"_275":276},"README.md",{"_273":326,"_279":327,"_281":327,"_86":240},{"_275":276},"tsconfig.json","actionData","errors"]

MCP directory API