作者 shinpr · shinpr/mcp-image
透過Gemini (Nano Banana 2/Pro)產生和編輯影像—自動提示最佳化、4K輸出、自然語言編輯、字元一致性。
mcp-image將Google的Gemini圖像模型（ Nano Banana 2/Nano Banana Pro ）包裝在單個「generate_image」工具後面。提供簡單的提示；伺服器在呼叫模型之前，會使用Subject-Context-Style架構豐富它，選擇品質層級（快速/平衡/品質） ，支援透過自然語言編輯影像，並保持各代人之間的字元一致性。高達4K輸出， 1: 1至21: 9長寬比。需要免費的Gemini API金鑰。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"mcp-image": {
"command": "npx",
"args": [
"-y",
"mcp-image"
],
"env": {
"GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
"IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
}
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"mcp-image": {
"command": "npx",
"args": [
"-y",
"mcp-image"
],
"env": {
"GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
"IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
}
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"mcp-image": {
"command": "npx",
"args": [
"-y",
"mcp-image"
],
"env": {
"GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
"IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
}
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"mcp-image": {
"command": "npx",
"args": [
"-y",
"mcp-image"
],
"env": {
"GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
"IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
}
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "mcp-image",
"command": "npx",
"args": [
"-y",
"mcp-image"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"mcp-image": {
"command": {
"path": "npx",
"args": [
"-y",
"mcp-image"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add mcp-image -- npx -y mcp-image一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 你想要一個全新的英雄形象，不想雜耍5個標籤。
結果： 只需幾分鐘即可發送的英雄形象，而非Midjourney的付費座位往返行程。
何時使用： 你需要6到12個插圖，看起來像是屬於一起的插圖。
結果： 一套有凝聚力的插畫集，無需聘請插畫師一天。
何時使用： 您有一張原始產品照片，並且希望在不使用 Photoshop 的情況下進行英雄處理。
結果： 幾分鐘內即可準備好目錄影像。
使用 mcp-image 進行一次性生成；用於管道的 ComfyUI
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| generate_image | prompt: str, tier?: fast|balanced|quality, aspect?: '1:1'|'16:9'|..., base_image?: path, size?: '1K'|'2K'|'4K' | 使用自然語言產生新圖像或編輯現有圖像 | 1 Gemini image call |
401 / API 金鑰無效確認 GEMINI_API_KEY 是來自 AI Studio 的原始 API 金鑰（不是 OAuth 令牌），並且已啟用映像產生。
curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY輸出已儲存但為空IMAGE_OUTPUT_DIR 可能不可寫或遺失。 創建它並重試。
touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe性格在代間漂移始終傳遞相同的基本圖像並在提示中包含“保持主題相同”。
Diff two generations visually| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| everart | 您擁有受過風格訓練的 Everart 模特 | 不同的提供者，不同的覆蓋風格 |
| comfyui-mcp-server | 您需要自訂 SD/FLUX 工作流程和完整的管道控制 | 更重的設定 |
| higgsfield-ai-prompt-skill | 您需要其他提供者提供及時的工程協助 | 僅提示——無推論 |