Banana Image MCP

🚀 香蕉图像MCP

香蕉图像MCP是一个基于MCP（模型上下文协议）的服务器，它能让Claude等AI助手借助谷歌最新的Gemini图像模型生成高质量图像。你只需描述需求，Claude就能从快速概念草图到惊艳的4K专业艺术作品，满足你的多样创作需求。

🚀 快速开始

在不到2分钟的时间内启动并运行。

前提条件

• 从 Google AI Studio 获取一个免费的Gemini API密钥。
• 安装 Claude Desktop。

安装

添加到你的Claude Desktop配置文件中：

{
  "mcpServers": {
    "banana-image": {
      "command": "uvx",
      "args": ["banana-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

# 清除此包的缓存
uv cache clean banana-image-mcp

# 然后重启Claude Desktop

"args": ["banana-image-mcp==1.0.1"]

✨ 主要特性

4K超高清输出

专业版模型可生成高达 3840px 的图像，非常适合专业工作、营销材料和印刷品。

双模型支持

• 快速版：2 - 3秒，最高1024px，适用于快速迭代。
• 专业版：5 - 8秒，最高4K，适用于最终交付物。

智能模型选择

服务器会根据你的提示自动选择最佳模型。说“快速草图”使用快速版，说“4K专业”使用专业版。

谷歌搜索知识融合

专业版模型利用谷歌搜索的真实世界知识生成更准确、符合事实的图像。

灵活的纵横比

支持所有常见比例：1:1、16:9、9:16、4:3、3:2、21:9 等。

自然语言编辑

使用简单的文本命令（如“让天空更有戏剧性”或“去除背景”）编辑现有图像。

📦 安装指南

见快速开始部分的安装步骤。

💻 使用示例

基础用法

只需自然地要求Claude生成图像：

"生成一只穿着宇航服的可爱猫咪"
"创建一张4K质量的咖啡杯专业产品照片"
"制作一个16:9的烹饪主题YouTube缩略图"
"编辑这张图片：让天空更有戏剧性"

模型比较

服务器默认使用专业版模型以获得最佳质量。可以使用关键词控制：

参数参考

环境变量

📚 详细文档

可创作内容

路线图

• [x] 4K分辨率输出（最高3840px）
• [x] 双模型支持（快速版 + 专业版）
• [x] 谷歌搜索知识融合
• [x] 灵活的纵横比
• [x] 自然语言图像编辑
• [x] GitHub Actions CI/CD
• [ ] 批量图像生成
• [ ] 图像到图像转换
• [ ] 视频生成支持
• [ ] 本地模型支持（Ollama）

查看 开放问题 以获取完整的提议功能和已知问题列表。

🔧 技术细节

开发

# 克隆仓库
git clone https://github.com/zengwenliang416/banana-image-mcp.git
cd banana-image-mcp

# 安装依赖
uv sync

# 在开发模式下运行
fastmcp dev banana_image_mcp.server:create_app

# 运行测试
pytest

# 代码检查和格式化
ruff check .
ruff format .

📄 许可证

本项目采用MIT许可证进行分发。有关更多信息，请参阅 LICENSE 文件。

联系我们

曾文亮 - @zengwenliang416

项目链接: https://github.com/zengwenliang416/banana-image-mcp

致谢

• FastMCP - 为该服务器提供支持的MCP框架。
• Google Gemini - 图像生成背后的AI模型。
• Anthropic MCP - 协议规范。
• Best-README-Template - README灵感来源。