让 Claude Code 与 Gemini CLI 无缝协作

⭐ 在GitHub上给我们点星~您的支持对我们意义重大！ 🙏😊

English | 简体中文

---

一、项目简介

Gemini-MCP 是一个 MCP 服务器，将 Google 的 Gemini CLI 工具封装为标准 MCP 协议接口，让 Claude Code 能够调用 Gemini 执行 AI 辅助编程任务。

🍟 本项目围绕gemini强大的前端设计能力提供了prompt，以丰富您的使用场景，我们十分推荐您进行配置！

---

二、快速开始

0. 前置要求

• 已安装并配置 Claude Code
• 已安装并配置 Gemini CLI
• 已安装 uv 工具

uv 安装方式：

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Linux/macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

注意：强烈推荐 Windows 用户在 WSL 中运行本项目！

1. 安装步骤

1.1 安装 GeminiMCP

claude mcp add gemini -s user --transport stdio -- uvx --from git+https://github.com/GuDaStudio/geminimcp.git geminimcp

1.2 验证安装

claude mcp list

看到 gemini: ... - ✓ Connected 说明安装成功

1.3 可选：配置自动允许

在 ~/.claude/settings.json 的 allow 项中添加 mcp__gemini__gemini

2. 配置claude code提示词（可选）

为使claude code更好完成与gemini的协同工作，我们极力推荐您在 ~/.claude/CLAUDE.md中添加以下内容

展开查看prompt

## Core Instruction for Gemini MCP

在任何时刻，你必须思考当前过程可以如何与 gemini 进行协作，如何调用 gemini 为你提供的MCP工具作为你**客观全面分析**的保障。

其中你**务必执行**以下几个步骤：

**1** 在你对用户需求**形成初步分析后**，
（1）首先将用户**原始需求（一字不差，严禁转述）**、以及你的初始思路告知gemini；
（2）与gemini进行**充分讨论、辩驳**，以完善需求分析和实施计划。这一步的结束标志为，**必须**确保对用户需求的透彻理解，并**生成切实可行的行动计划**。

**2** 在实施具体编码任务前，你**必须向gemini索要代码实现原型**（要求gemini仅给出unified diff patch，严禁对代码做任何真实修改）。在获取代码原型后，你**只能以此为逻辑参考，再次对代码修改进行重写**，形成企业生产级别、可读性极高、可维护性极高的代码后，才能实施具体编程修改任务。
  - **注意：** Gemini 十分擅长前端代码，并精通样式、UI组件设计。在涉及前端代码时，你必须向其索要代码原型（CSS/React/Vue/HTML等前端代码），任何时刻，你**必须以gemini的前端设计（原型代码）为最终的前端代码基点**。
  - 例如，当你识别到用户给出了前端设计需求，你的首要行为必须自动调整为，将用户需求原封不动转发给gemini，并让其出具代码示例（此阶段严禁对用户需求进行任何改动、简写等等）。即你必须从gemini获取代码基点，才可以进行接下来的各种行为。

## Gemini Tool Invocation Specification

 1. 工具概述

  gemini MCP 提供了一个工具 `gemini`，用于调用 Google Gemini 模型执行 AI 任务。该工具拥有极强的前端审美、任务规划与需求理解能力，但在**上下文长度（Effective 32k）**上有限制。

2. 使用方式与规范

  **必须遵守的限制**：
  - **会话管理**：捕获返回的 `SESSION_ID` 用于多轮对话。
  - **后端避让**：严禁让 Gemini 编写复杂的后端业务逻辑代码。

  **擅长场景（必须优先调用 Gemini）**：
  - **需求清晰化**：在任务开始阶段辅助生成引导性问题。
  - **任务规划**：生成 Step-by-step 的实施计划。
  - **前端原型**：编写 CSS、HTML、UI 组件代码，调整样式风格。

---

三、工具说明

展开查看gemini 工具详情

gemini 工具

参数	类型	必填	默认值	说明
PROMPT	str	✅	-	发送给 Gemini 的任务指令
sandbox	bool	❌	False	是否启用沙箱模式
SESSION_ID	str	❌	""	会话 ID（空则开启新会话）
return_all_messages	bool	❌	False	是否返回完整消息记录
model	str	❌	""	指定模型（默认使用 Gemini CLI 配置）

返回值结构

成功时：

{
  "success": true,
  "SESSION_ID": "session-uuid",
  "agent_messages": "Gemini 的回复内容..."
}

启用 return_all_messages 时额外包含：

{
  "all_messages": [...]
}

失败时：

{
  "success": false,
  "error": "错误信息描述"
}

---

四、FAQ

Q1: 与 Gemini CLI 直接使用有什么区别？

GeminiMCP 将 Gemini CLI 封装为 MCP 协议，使 Claude Code 可以程序化调用，支持会话管理和结构化返回。

Q2: 会话会冲突吗？

不会。每个会话使用独立的 SESSION_ID，完全隔离。

---

🤝 贡献指南

# 克隆仓库
git clone https://github.com/GuDaStudio/geminimcp.git
cd geminimcp

# 安装依赖
uv sync

---

📄 许可证

本项目采用 MIT License 开源协议。

Copyright (c) 2025 guda.studio

---

用 🌟 为本项目助力~