Gemini-MCP-XHZJ

🚀 让 Windsurf AI IDE 调用 Google Gemini，每日 1000 次免费额度！

专门适配 Windsurf AI IDE 的 Gemini MCP 服务。

👋 交流学习

加我好友

欢迎关注

✨ 功能特点

🆓 免费使用：使用你自己的 Google 账号，每日 1000 次免费调用
🔄 多账号切换：配额用完可一键切换其他 Google 账号
🛡️ 代理支持：内置 Clash 代理配置（端口 7890）
📝 会话保持：支持多轮对话上下文
🖥️ Windows 友好：提供中文管理工具

📁 项目结构

Gemini-MCP-XHZJ/
├── 📄 Gemini-MCP-XHZJ.bat      # 管理工具（检查状态/登录/切换账号）
├── 📄 mcp-config.json          # MCP 服务配置文件
├── 📄 windsurf_mcp_config.json # Windsurf MCP 配置示例
├── 📄 LICENSE                  # Apache-2.0 开源协议
├── 📄 README.md                # 本文件
└── 📂 mcp-servers/
    └── 📂 gemini-server/
        ├── 📄 index.js         # MCP 服务核心代码
        └── 📄 package.json     # Node.js 依赖配置

文件说明

| 文件 | 作用 | |------|------| | Gemini-MCP-XHZJ.bat | Windows 管理工具，双击运行可检查状态、登录、切换账号 | | mcp-config.json | 代理和 Gemini CLI 的配置参数 | | windsurf_mcp_config.json | Windsurf 的 MCP 配置示例，需复制到 Windsurf 配置目录 | | mcp-servers/gemini-server/index.js | MCP 服务核心，封装 Gemini CLI 为 MCP 协议 |

🔧 安装步骤

第一步：安装前置依赖

1. 安装 Node.js

下载并安装 Node.js（建议 LTS 版本）

验证安装：

node --version   # 应显示 v18.x.x 或更高
npm --version    # 应显示 9.x.x 或更高

2. 安装 Gemini CLI

打开命令提示符（CMD）或 PowerShell，运行：

npm install -g @google/gemini-cli

验证安装：

gemini --version

3. 准备代理工具

需要能访问 Google 的代理工具（如 Clash），默认端口 7890。

如果你的代理端口不是 7890，需要修改 mcp-config.json 中的端口号。

第二步：下载本项目

方式一：Git 克隆

git clone https://github.com/XHZJme/Gemini-MCP-XHZJ.git

方式二：直接下载

点击页面右上角绿色 Code 按钮 → Download ZIP → 解压到任意目录

第三步：登录 Google 账号

确保代理已开启（Clash 等）
双击运行 Gemini-MCP-XHZJ.bat
输入 2 选择「登录认证」
在弹出的界面中用方向键选择 Login with Google，按 Enter
浏览器会自动打开，完成 Google 账号登录
登录成功后，终端会显示认证成功

第四步：配置 Windsurf

打开 Windsurf AI IDE
按 Ctrl + Shift + P 打开命令面板
输入 Open MCP Config 并选择
在打开的配置文件中，添加以下内容：

{
  "mcpServers": {
    "Gemini-MCP-XHZJ": {
      "command": "node",
      "args": [
        "你的项目路径\\mcp-servers\\gemini-server\\index.js"
      ],
      "env": {
        "HTTP_PROXY": "http://127.0.0.1:7890",
        "HTTPS_PROXY": "http://127.0.0.1:7890",
        "GEMINI_IDE_INTEGRATION": "false",
        "BROWSER": "echo",
        "GEMINI_CLI_SUPPRESS_BROWSER": "true"
      }
    }
  }
}

⚠️ 注意：将 你的项目路径 替换为实际路径，Windows 路径使用双反斜杠 \\

保存配置，重启 Windsurf

🎮 使用方法

管理工具

双击 Gemini-MCP-XHZJ.bat，可以：

| 选项 | 功能 | |------|------| | 1 | 检查状态 - 查看 Gemini CLI 安装和认证状态 | | 2 | 登录认证 - 用 Google 账号登录 | | 3 | 切换账号 - 配额用完时切换其他账号 | | 4 | 退出 |

在 Windsurf 中使用

配置完成后，Windsurf 的 AI 助手（Cascade）可以调用 Gemini 进行：

代码审查
技术问答
UI/UX 设计建议

❓ 常见问题

Q: 提示「Gemini CLI 未安装」？

运行以下命令安装：

npm install -g @google/gemini-cli

Q: 登录时浏览器打不开？

检查代理是否开启
检查代理端口是否为 7890（或修改配置文件）
手动打开浏览器访问终端显示的链接

Q: 配额用完了怎么办？

运行 Gemini-MCP-XHZJ.bat
选择 3 切换账号
用另一个 Google 账号登录

Q: Windsurf 找不到 MCP 服务？

检查配置文件路径是否正确
检查 Node.js 是否已安装
重启 Windsurf

📊 工作流程图

graph LR
    A[Windsurf<br/>Cascade] -->|MCP 协议| B[MCP Server<br/>index.js]
    B -->|调用| C[Gemini CLI<br/>Google]
    C -->|JSON 流式输出| B
    B -->|返回结果| A
    
    A -.->|用户交互| A
    B -.->|请求转发| B
    C -.->|AI 响应| C
    
    style A fill:#e1f5ff,stroke:#01579b,stroke-width:2px
    style B fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style C fill:#f3e5f5,stroke:#4a148c,stroke-width:2px

📜 开源协议

本项目采用 Apache-2.0 协议开源。

🙏 致谢

老金 - 本项目基于 Claudecode-Codex-Gemini 二次开发
Google Gemini - 提供 CLI 工具和强大的模型能力

Contributors

Gemini-MCP-XHZJ - Gemini MCP Xhzj by XHZJme

MCP Servers