Claude-to-Gemini MCP Server

Claude到Gemini MCP服务器

Claude Code将Google Gemini用作模型上下文协议（MCP）服务器的Agent-to-Agent集成项目

🎯 项目目的

• 克劳德代码：主AI（常规编码、调试、文件创建/修改）
• 双子座：子AI（大型上下文分析、代码库评论、按用途生成6种图像）

主要功能

1. ask_gemini -生成文本/代码

• 用途：常规Gemini调用，大上下文分析
• 选择型号:

- flash （默认）：Gemini 2.5 Flash-免费，快速 - pro: 双子座3.1专业版 -最新机型（2026.02发布），最高性能

• 上下文：最多1M令牌

2. gemini_analyze_codebase -分析代码库

• 用途：全面代码库分析
• 分析类型:

- architecture：体系结构模式分析 - duplications：检测重复代码 - security：安全漏洞检查 - performance：性能优化机会 - general：综合分析

3. generate_logo -创建徽标/图标

• 用途：创建徽标、图标和品牌资源
• 模型：纳米香蕉Pro(gemini-3-pro-image-preview）-专业的Asset制作特色
• 参数:

- prompt：徽标说明（英文） - brandName：要包括的品牌/文本名称（可选） - style: minimal | modern | vintage | playful | corporate - colorScheme：颜色系列（可选）

• 特点：简单、可缩放的设计，1:1比例基本

4. generate_illustration -创建插图/艺术作品

• 用途：插图，艺术作品，角色，概念艺术
• 模型：纳米香蕉2(gemini-3.1-flash-image-preview）-快速创建， 免费
• 参数:

- prompt：插图说明（英文） - style: watercolor | cartoon | vector | oil_painting | sketch | anime | pixel_art - mood: cheerful | dark | calm | dramatic （可选） - aspectRatio: 1:1 | 16:9 | 9:16 | 4:3 | 3:4 - numberOfImages：创建数量（1-4）

5. generate_infographic -创建信息图/图表

• 用途：信息图、图表、流程图、时间轴
• 模型：纳米香蕉Pro(gemini-3-pro-image-preview）-优化事故模式+文本呈现
• 参数:

- prompt：信息图主题/内容（英文） - data：要可视化的数据/信息（可选） - type: infographic | diagram | flowchart | timeline | comparison | stats - aspectRatio: 1:2 （默认）| 1:4 | 1:1 | 16:9

• 特点：易于阅读的文本渲染，支持垂直长布局

6. generate_photo -生成真实照片

• 用途：照片真实感图片，产品木业，广告图片
• 模型：图像4(imagen-4.0-generate-001）-最高的真实品质， 收费
• 参数:

- prompt：图片说明（英文） - style: natural | studio | cinematic | aerial | macro - numberOfImages：创建数量（1-4） - aspectRatio: 1:1 | 16:9 | 9:16 | 4:3 | 3:4

• 特点：最高4K分辨率，自动包含SynthID水印

7. generate_banner -创建营销横幅/SNS图像

• 用途：营销横幅、SNS图片、缩略图、海报
• 模型：纳米香蕉Pro(gemini-3-pro-image-preview）-文本+图形组合
• 参数:

- prompt：横幅广告说明（英文） - text：要包括在横幅广告中的文本（可选） - platform: facebook | instagram | twitter | youtube | linkedin | web - aspectRatio：按平台自动设置

• 特点：提供各平台的最佳尺寸预设

8. edit_image -编辑/修改图像

• 用途：添加/删除/修改现有图像中的元素
• 模型：纳米香蕉2(gemini-3.1-flash-image-preview) - 免费
• 参数:

- prompt：编辑说明（英文） - imagePath：要编辑的图像文件路径 - action: modify | add | remove | style_transfer | enhance

• 特点：交互编辑，支持多轮交互式修改

🛠 技术堆栈

• 运行时：Node.js 18+
• MCP-SDK：@modelcontextprotocol/sdk
• AI API：Google Gemini API（@Google/generative-ai）
• 集成开发环境：Claude Code（CLI+VSCode扩展）

📦 安装方法

1.事前准备

• 安装Node.js 18或更高版本
• Claude Pro/Max计划订阅
• Google Gemini API密钥发放（ai.google.dev)

2.项目克隆

git clone https://github.com/YOUR_USERNAME/claude-to-gemini.git
cd claude-to-gemini

3.安装依赖性

npm install

4.注册MCP服务器

claude mcp add gemini \
  --env GEMINI_API_KEY=YOUR_API_KEY_HERE \
  -- node /ABSOLUTE_PATH/claude-to-gemini/index.js

注意:

• YOUR_API_KEY_HERE使用实际Gemini API密钥替换
• /ABSOLUTE_PATH/用实际项目路径替换（例如： /Users/username/projects/claude-to-gemini/index.js)

5.确认

claude mcp list

输出示例：

gemini - node /Users/username/projects/claude-to-gemini/index.js

🚀 使用方法

Claude Code入门

claude

默认使用（Flash型号，免费）

ask_gemini 도구를 사용해서 "이 프로젝트 전체 구조를 분석해줘" 물어봐줘

使用Pro型号（收费，高性能）

ask_gemini 도구를 사용해서 model을 "pro"로 설정하고 "복잡한 아키텍처 설계해줘" 물어봐줘

代码库分析

gemini_analyze_codebase 도구로 보안 취약점을 찾아줘

创建徽标

generate_logo 도구로 brandName을 "CafeKiosk"로, style을 "modern"으로 설정하고
"A minimalist coffee cup logo with geometric shapes" 로고 만들어줘

创建插图（免费）

generate_illustration 도구로 style을 "watercolor"로 설정하고
"A cozy cafe interior with warm lighting" 삽화 생성해줘

创建信息图

generate_infographic 도구로 type을 "flowchart"로 설정하고
"User authentication flow: login, verify, 2FA, dashboard" 다이어그램 만들어줘

生成真实照片（付费Imagen4）

generate_photo 도구로 style을 "studio"로, numberOfImages를 4로 설정하고
"Professional food photography of a latte with beautiful latte art" 이미지 4개 생성해줘

创建营销横幅

generate_banner 도구로 platform을 "instagram"으로 설정하고
text를 "Grand Opening 50% OFF"로
"Bright modern cafe promotion banner with coffee beans" 배너 만들어줘

编辑图像（免费）

edit_image 도구로 action을 "remove"로, imagePath를 "./photo.png"으로 설정하고
"Remove the background person and keep only the coffee cup" 편집해줘

💡 使用方案

方案1：设计新的项目体系结构

ask_gemini 도구로 React + Express + PostgreSQL
전자상거래 앱의 전체 아키텍처를 설계해줘

方案2：分析旧代码

gemini_analyze_codebase 도구로
focus를 'duplications'로 설정해서 중복 코드를 찾아줘

场景3：大规模重构

ask_gemini 도구로 이 프로젝트 전체를 읽고
모던한 아키텍처로 마이그레이션 계획을 세워줘

📚 实战指南

如何在实务中运用？

更详细的实战运用方法是 📖 实战使用指南（USECASES.md）请参考！

主要内容：

• 🔍 副射手代码评论（每天早上例程）
• 🏗️ 大规模重构（1200行迁移）
• 🚀 项目启动（1小时内确定关键点）
• 🎨 体系结构设计（Monorepo结构）
• 🖼️ 创建特定用途的图像（徽标、插图、信息图、照片、横幅、编辑）
• 💡 提示和技巧（优化成本，选择型号）

📊 比较模型

文本/代码生成模型

映像创建模型

ATI安全注意事项

API密钥保护

绝对禁止:

• 将API密钥上传到GitHub
• 在代码中硬编码API密钥
• 在公共场所共享API密钥

建议:

• 只管理环境变量
• ✅ .gitignore呃 .claude.json 包含
• API密钥泄露时立即补发

.gitignore必需的内容

node_modules/
.claude.json
.env
*.key

🤝 贡献方法

1. 分叉项目
2. 创建功能分支(git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add some AmazingFeature')
4. 推到分支机构(git push origin feature/AmazingFeature)
5. 打开拉取请求

📝 许可证

MIT License-详细信息 许可证 文件引用

🔗 参考资料

• MCP官方文档
• Gemini API文档
• Claude Code文档

📧 咨询

与项目相关的咨询：

______________________________________________________________________

制作❤️ \[你的名字\]