AI导哈

Gemini MCP 服务器

一个本地MCP服务器，用于将高计算量任务委托给Gemini的大容量上下文窗口处理。

  • by ethan-tsai-tsai
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ethan-tsai-tsai/gemini-mcp-server

使用说明

Gemini MCP Server

Let Claude Code delegate token-heavy tasks to Gemini's 1M+ token context window.

这是什么？

本地MCP服务器，用于包装 gemini 命令行界面，让任何MCP客户端（Claude Code、Cursor等）将昂贵的任务卸载到Gemini 2.5 Pro的庞大上下文窗口中。

使用案例：

  • 在不烧毁克劳德令牌的情况下总结一个5000行的文件
  • 一次性分析整个代码库目录
  • 从其他模型获取第二意见代码审查
  • 处理超出舒适上下文限制的巨大日志或数据文件
  • 通过谷歌搜索基础在网上搜索最新信息
  • 自动审查PR或分支差异，无需手动复制粘贴

MCP工具

工具 说明
gemini_query 使用可选文件上下文向Gemini发送提示
gemini_summarize 总结一个文件或整个目录/代码库
gemini_analyze 深入分析代码库结构、模式和问题
gemini_review 代码审查，并提供可操作的反馈（手动差异/文件）
gemini_search 基于谷歌搜索的网络搜索——通过源引用获取最新信息
gemini_pr_review Git感知PR/分支审查——自动获取差异和提交历史记录

先决条件

快速开始

无需克隆——只需添加到MCP客户端配置中：

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
Claude Code

运行：

claude mcp add gemini -- npx -y @ethantsaitsai/gemini-mcp-server

或添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
Gemini CLI

添加 ~/.gemini/settings.json:

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
Claude Desktop

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
Cursor

首选 光标设置>MCP>添加新的MCP服务器，然后添加：

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
VS Code (Copilot)

添加 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
Windsurf

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@ethantsaitsai/gemini-mcp-server"]
    }
  }
}
From source (alternative) 
git clone https://github.com/ethan-tsai-tsai/gemini-mcp-server.git
cd gemini-mcp-server
npm install
npm start

环境变量

变量 默认值 描述
GEMINI_CLI_PATH gemini 通往双子座双星的道路
GEMINI_MODEL gemini-2.5-pro 默认Gemini模型
GEMINI_TIMEOUT_MS 120000 每次调用超时（ms）

运作原理

┌─────────────┐     MCP (stdio)     ┌──────────────┐    child_process    ┌─────────────┐
│  AI Client  │ ◄──────────────────► │  index.js    │ ◄────────────────► │  gemini CLI  │
│ (Claude,    │   gemini_query()     │  (MCP Server)│   spawn/execFile   │  (Google)    │
│  Cursor...) │   gemini_summarize() │              │                    │              │
│             │   gemini_analyze()   │              │                    │              │
│             │   gemini_review()    │              │                    │              │
│             │   gemini_search()    │              │                    │              │
│             │   gemini_pr_review() │              │                    │              │
└─────────────┘                      └──────────────┘                    └─────────────┘

安全

  • 不 console.log --stdout是为JSON-RPC保留的；所有日志记录用途 stderr
  • 无外壳注射 --用途 spawn/execFile 而不是 exec；所有输入都经过消毒
  • 跳过二进制文件 --自动检测并跳过非文本文件
  • 路径验证 --所有文件路径在使用前都经过清理

许可证

国际学生中心

相关 MCP