Gemini Mcp

MCP Server Gemini

用于将 Google Gemini 3 模型与 Claude Code 集成的模型上下文协议（MCP）服务，让两种 AI 系统能够强强联手。现在还配备了精美的 CLI！

**MCP Registry 支持：**现在可在官方 MCP 生态系统中发现！

功能

功能	描述
深度研究 Agent	自主执行多步骤研究，支持网页搜索和引用
Token 计数	在调用 API 前统计 token 数量并估算成本
文本转语音	30 种独特音色，支持单人朗读或双人对话
URL 分析	分析、比较网页并从中提取数据
上下文缓存	缓存大型文档，以便高效重复查询
YouTube 分析	通过 URL 分析视频，并支持按时间戳截取
文档分析	分析 PDF、DOCX、电子表格并提取表格
4K 图像生成	生成最高 4K 分辨率的图像，支持 10 种宽高比
多轮图像编辑	通过对话逐步改进图像
视频生成	使用 Veo 2.0 创建视频（异步轮询）
代码执行	Gemini 编写并运行 Python 代码（pandas、numpy、matplotlib）
Google 搜索	获取实时网页信息并附带行内引用
结构化输出	返回经过架构验证的 JSON 响应
数据提取	从文本中提取实体、事实和情感
思考级别	控制推理深度（minimal/low/medium/high）
直接查询	向 Gemini 3 Pro/Flash 模型发送提示词
头脑风暴	Claude 与 Gemini 协作解决问题
代码分析	分析代码的质量、安全性和性能
摘要	按不同详细程度总结内容

---

快速安装

Claude Code 的 MCP 服务

# Using npm (Recommended)
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY npx -y @rlabs-inc/gemini-mcp

# Using bun
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY bunx @rlabs-inc/gemini-mcp

CLI（全局安装）

# Install globally
npm install -g @rlabs-inc/gemini-mcp

# Set your API key once (stored securely)
gcli config set api-key YOUR_KEY

# Now use any command!
gcli search "latest news"
glci image "sunset over mountains" --ratio 16:9

**获取 API 密钥：**访问 Google AI Studio——免费且只需几秒钟！

安装选项

# With verbose logging
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY VERBOSE=true bunx -y @rlabs-inc/gemini-mcp

# With custom output directory for generated images/videos
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY GEMINI_OUTPUT_DIR=/path/to/output bunx -y @rlabs-inc/gemini-mcp

---

可用工具

gemini-query

直接向 Gemini 发送查询，并控制思考级别：

prompt: "Explain quantum entanglement"
model: "pro" or "flash"
thinkingLevel: "low" | "medium" | "high" (optional)

• low：响应快速，推理程度最低
• medium：平衡模式（仅限 Flash）
• high：针对复杂任务进行深度推理（默认）

gemini-generate-image

使用 Nano Banana Pro 生成图像（Claude 可以看到图像！）：

prompt: "a futuristic city at sunset"
style: "cyberpunk" (optional)
aspectRatio: "16:9" (1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9)
imageSize: "2K" (1K, 2K, 4K)
useGoogleSearch: false (ground in real-world info)
thinkingLevel: "high" (optional - minimal, low, medium, high)
personGeneration: "ALLOW_ALL" (optional - ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE)
seed: 42 (optional - for reproducible results)

gemini-start-image-edit

启动多轮图像编辑会话：

prompt: "a cozy cabin in the mountains"
aspectRatio: "16:9"
imageSize: "2K"
useGoogleSearch: false
thinkingLevel: "high" (optional - minimal, low, medium, high)
personGeneration: "ALLOW_ALL" (optional - ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE)
seed: 42 (optional - for reproducible results)

返回用于迭代编辑的会话 ID。

gemini-continue-image-edit

继续优化图像：

sessionId: "edit-123456789"
prompt: "add snow on the roof and make it nighttime"

gemini-end-image-edit

关闭编辑会话：

sessionId: "edit-123456789"

gemini-list-image-sessions

列出所有活动的编辑会话。

gemini-generate-video

使用 Veo 生成视频：

prompt: "a cat playing piano"
aspectRatio: "16:9" (optional)
negativePrompt: "blurry, text" (optional)

视频生成为异步操作（需要 1-5 分钟）。使用 gemini-check-video 轮询状态。

gemini-check-video

检查视频生成状态，并在完成后下载：

operationId: "operations/xxx-xxx-xxx"

gemini-analyze-code

分析代码问题：

code: "function foo() { ... }"
language: "typescript" (optional)
focus: "quality" | "security" | "performance" | "bugs" | "general"

gemini-analyze-text

分析文本内容：

text: "Your text here..."
type: "sentiment" | "summary" | "entities" | "key-points" | "general"

gemini-brainstorm

协作式头脑风暴：

prompt: "How could we implement real-time collaboration?"
claudeThoughts: "I think we should use WebSockets..."
maxRounds: 3 (optional)

gemini-summarize

总结内容：

content: "Long text to summarize..."
length: "brief" | "moderate" | "detailed"
format: "paragraph" | "bullet-points" | "outline"

gemini-run-code

让 Gemini 编写并执行 Python 代码：

prompt: "Calculate the first 50 prime numbers and plot them"
data: "optional CSV data to analyze" (optional)

支持的库：numpy、pandas、matplotlib、scipy、scikit-learn、tensorflow 等。 生成的图表会保存到输出目录，并以图像形式返回。

gemini-search

实时网页搜索并提供引用：

query: "What happened in tech news this week?"
returnCitations: true (default)

返回有依据的回答，包含内联引用和来源 URL。

gemini-structured

获取符合指定架构的 JSON 响应：

prompt: "Extract the meeting details from this email..."
schema: '{"type":"object","properties":{"date":{"type":"string"},"attendees":{"type":"array"}}}'
useGoogleSearch: false (optional)

gemini-extract

用于常见提取模式的便捷工具：

text: "Your text to analyze..."
extractType: "entities" | "facts" | "summary" | "keywords" | "sentiment" | "custom"
customFields: "name, date, amount" (for custom extraction)

gemini-youtube

直接分析 YouTube 视频：

url: "https://www.youtube.com/watch?v=..."
question: "What happens at 2:30?"
startTime: "1m30s" (optional, for clipping)
endTime: "5m00s" (optional, for clipping)

gemini-youtube-summary

快速总结视频：

url: "https://www.youtube.com/watch?v=..."
style: "brief" | "detailed" | "bullet-points" | "chapters"

gemini-analyze-document

分析 PDF 和文档：

filePath: "/path/to/document.pdf"
question: "Summarize the key findings"
mediaResolution: "low" | "medium" | "high"

gemini-summarize-pdf

快速总结 PDF：

filePath: "/path/to/document.pdf"
style: "brief" | "detailed" | "outline" | "key-points"

gemini-extract-tables

从文档中提取表格：

filePath: "/path/to/document.pdf"
outputFormat: "markdown" | "csv" | "json"

---

工作流：Claude + Gemini

开发的绝佳组合：

Claude	Gemini
复杂逻辑	前端/UI
架构	视觉组件
后端代码	图像生成
集成	React/CSS 样式
推理	创意生成

工作流示例：

1. 让 Claude 设计后端 API
2. 使用 gemini-generate-image 制作 UI 模型图
3. 让 Gemini 通过 gemini-query 生成 React 组件
4. 使用多轮编辑优化视觉效果
5. 让 Claude 将所有内容整合起来

---

环境变量

Variable	Required	Default	Description
GEMINI_API_KEY	是	-	你的 Google Gemini API 密钥
GEMINI_OUTPUT_DIR	否	./gemini-output	生成文件的保存位置
GEMINI_MODEL	否	-	覆盖初始化测试所用的模型
GEMINI_PRO_MODEL	否	gemini-3-pro-preview	Pro 模型（Gemini 3）
GEMINI_FLASH_MODEL	否	gemini-3-flash-preview	Flash 模型（Gemini 3）
GEMINI_IMAGE_MODEL	否	gemini-3-pro-image-preview	图像模型（Nano Banana Pro）
GEMINI_IMAGE_THINKING_LEVEL	否	high	图像生成的默认思考级别（minimal、low、medium、high）
GEMINI_VIDEO_MODEL	否	veo-2.0-generate-001	视频模型
VERBOSE	否	false	启用详细日志
QUIET	否	false	尽量减少日志
GEMINI_ENABLED_TOOLS	否	-	要加载的工具组列表，以逗号分隔（例如，query,search,image-gen）
GEMINI_TOOL_PRESET	否	-	预设配置：minimal、text、image、research、media、full

---

工具配置

默认情况下会加载全部 37 个工具。若要减少上下文占用，可配置要加载的工具：

可用预设

Preset	Tool Groups
minimal	query, brainstorm
text	query, brainstorm, analyze, summarize, structured
image	query, image-gen, image-edit, image-analyze
research	query, search, deep-research, url-context, document
media	query, image-gen, image-edit, image-analyze, video-gen, youtube, speech
full	全部 18 个工具组（默认）

使用预设

# Minimal - query and brainstorm
GEMINI_TOOL_PRESET=minimal

# Text processing
GEMINI_TOOL_PRESET=text  # query, brainstorm, analyze, summarize, structured

# Image workflows
GEMINI_TOOL_PRESET=image  # query, image-gen, image-edit, image-analyze

# Research workflows
GEMINI_TOOL_PRESET=research  # query, search, deep-research, url-context, document

使用显式工具列表

# Only specific tools
GEMINI_ENABLED_TOOLS=query,search,image-gen

组合使用预设和显式列表

# Start with preset, add extras
GEMINI_TOOL_PRESET=minimal
GEMINI_ENABLED_TOOLS=search,image-gen  # Adds to minimal preset

可用工具组

组	工具
query	gemini-query
brainstorm	gemini-brainstorm
analyze	gemini-analyze-code, gemini-analyze-text
summarize	gemini-summarize
image-gen	gemini-generate-image, gemini-image-prompt
image-edit	gemini-start-image-edit, gemini-continue-image-edit, gemini-end-image-edit, gemini-list-image-sessions
video-gen	gemini-generate-video, gemini-check-video
code-exec	gemini-run-code
search	gemini-search
structured	gemini-structured, gemini-extract
youtube	gemini-youtube, gemini-youtube-summary
document	gemini-analyze-document, gemini-summarize-pdf, gemini-extract-tables
url-context	gemini-analyze-url, gemini-compare-urls, gemini-extract-from-url
cache	gemini-create-cache, gemini-query-cache, gemini-list-caches, gemini-delete-cache
speech	gemini-speak, gemini-dialogue, gemini-list-voices
token-count	gemini-count-tokens
deep-research	gemini-deep-research, gemini-check-research, gemini-research-followup
image-analyze	gemini-analyze-image

---

手动安装

全局安装

# Using npm
npm install -g @rlabs-inc/gemini-mcp

# Using bun
bun install -g @rlabs-inc/gemini-mcp

Claude Code 配置

{
  "gemini": {
    "command": "npx",
    "args": ["-y", "@rlabs-inc/gemini-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-api-key",
      "GEMINI_OUTPUT_DIR": "/path/to/save/files"
    }
  }
}

如果必须使用代理连接 gemini，请将 xxxx 替换为实际的代理端口：

{
  "gemini": {
    "command": "npx",
    "args": ["-y", "@rlabs-inc/gemini-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-api-key",
      "GEMINI_OUTPUT_DIR": "/path/to/save/files",
      "HTTP_PROXY": "http://127.0.0.1:xxxx",
      "HTTPS_PROXY": "http://127.0.0.1:xxxx"
    }
  }
}

---

故障排除

速率限制（429 错误）

如果免费版遇到速率限制：

• 设置 GEMINI_MODEL=gemini-3-flash-preview，在初始化时使用 Flash（速率限制更高）
• 或升级到付费方案

连接问题

1. 在 Google AI Studio 验证 API 密钥
2. 检查服务状态：claude mcp list
3. 尝试启用详细日志：VERBOSE=true

图像／视频问题

• 确保 API 密钥有权使用图像／视频生成
• 检查输出目录权限
• 文件保存至 GEMINI_OUTPUT_DIR（默认值：./gemini-output）
• 生成 4K 图像需要更长时间

---

先前版本

0.7.2

精美的 CLI，搭配多种主题！ 可直接在终端中使用 Gemini：

# Install globally
npm install -g @rlabs-inc/gemini-mcp

# Set your API key once
gcli config set api-key YOUR_KEY

# Generate images, videos, search, research, and more!
gcli image "a cat astronaut" --size 4K
gcli search "latest AI news"
gcli research "quantum computing applications" --wait
gcli speak "Hello world" --voice Puck

5 款精美主题： terminal、neon、ocean、forest、minimal

CLI 命令：

• gcli query - 直接向 Gemini 提问，并设置思考级别
• gcli search - 实时网页搜索，并附带引用
• gcli research - 深度研究 Agent
• gcli image - 生成图像（最高 4K）
• gcli video - 使用 Veo 生成视频
• gcli speak - 使用 30 种声音进行文本转语音
• gcli tokens - 统计 Token 并估算费用
• gcli config - 管理设置

v0.6.x： 深度研究、Token 统计、TTS、URL 分析、上下文缓存 v0.5.x： 30 多种工具、YouTube 分析、文档分析 v0.4.x： 代码执行、Google 搜索 v0.3.x： 思考级别、结构化输出、4K 图像 v0.2.x： 使用 Veo 生成图像／视频

---

开发

git clone https://github.com/rlabs-inc/gemini-mcp.git
cd gemini-mcp
bun install
bun run build
bun run dev -- --verbose

脚本

命令	说明
bun run build	构建生产版本
bun run dev	监视模式下进行开发
bun run typecheck	类型检查，不生成输出
bun run format	使用 Prettier 格式化
bun run lint	使用 ESLint 检查代码

---

许可证

MIT 许可证

---

由 Claude 与 Gemini 协作打造