使用说明
Installation
Gemini Image MCP Server
Google Gemini-based image generation and editing service providing AI image processing capabilities through MCP protocol.
Features
- Text-to-Image Generation (generate_image)
- Image Editing & Modification (edit_image)
- PNG Format Support
- Automatic File Path Management
安装运行
# 安装依赖
uv pip install -r requirements.txt
# 设置环境变量（Linux/macOS）
export GEMINI_API_KEY=your_api_key_here
# Windows 设置：
setx GEMINI_API_KEY "your_api_key_here"
API Documentation
generate_image
@mcp.tool()
async def generate_image(prompt: str, save_path: str = None) -> str:
"""
:param prompt: Image generation prompt (works better in English)
:param save_path: Optional save path (default: generated-images/ directory)
:return: Absolute path of generated image
"""
edit_image
@mcp.tool()
async def edit_image(prompt: str, image_path: str, save_path: str = None) -> str:
"""
:param prompt: 图像编辑指令（支持中文）
:param image_path: 原始图片路径
:param save_path: 可选保存路径，默认生成在 generated-images/ 目录
:return: 编辑后图片的绝对路径
"""
MCP Configuration
Add to mcp.json:
{
"mcpServers": {
"gemini-image-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/",
"run",
"server.py"
]
}
}
}
Important Notes
- Ensure replacement of absolute paths in configuration
- API key must be set through environment variables
- Recommended to run sample code first for initial usage
- Generated images default to generated-images directory
