Gemini CLI MCP Server

Gemini CLI MCP服务器

一个模型上下文协议（MCP）服务器，它将Gemini CLI与Claude Code集成在一起，使用code2prompt进行全面的代码库分析。

特性

• 全面的代码库审查：使用Gemini的1M令牌上下文窗口进行完整的架构分析
• 目标成分分析：重点分析特定文件/文件夹
• Code2Prompt集成：通过令牌优化实现高效的代码库上下文提取
• OAuth支持：适用于您现有的Gemini CLI OAuth身份验证
• 克劳德代码子代理：智能分析编排的专用代理

先决条件

所需工具

1. Node.js 18+ -用于运行MCP服务器
2. Gemini CLI -带有OAuth身份验证的Google CLI工具
3. 代码2提示 -用于代码库提取的Rust CLI工具
4. 克劳德代码 -用于子代理集成

安装步骤

1.安装Gemini CLI

npm install -g @google/gemini-cli

使用您的Google帐户进行身份验证：

gemini
# Follow OAuth setup prompts

2.安装代码2提示

# macOS/Linux with Homebrew
brew install mufeedvh/tap/code2prompt

# Or build from source
cargo install code2prompt

3.安装MCP服务器依赖项

cd /Users/ryangould/Dev/gemini-cli-mcp
npm install

设置和配置

1.构建MCP服务器

npm run build

2.配置克劳德代码MCP设置

添加到您的Claude Code MCP设置中（通常 ~/.config/claude-desktop/mcp_settings.json):

{
  "mcpServers": {
    "gemini-cli-mcp": {
      "command": "node",
      "args": [
        "/Users/ryangould/Dev/gemini-cli-mcp/dist/server.js"
      ],
      "env": {}
    }
  }
}

3.重新启动克劳德代码

重新启动Claude Code以加载新的MCP服务器。

可用工具

gemini_comprehensive_review

使用Gemini CLI执行完整的代码库架构审查。

参数：

• workingDir （string）：代码库目录的路径
• excludePatterns （数组，可选）：要排除的其他模式

使用示例：

// Called by Claude Code sub-agent
gemini_comprehensive_review({
  workingDir: "/path/to/your/project"
})

gemini_targeted_analysis

以专注的见解分析特定的文件或文件夹。

参数：

• workingDir （string）：代码库目录的路径
• targetPaths （数组）：要分析的特定文件/文件夹
• analysisContext （字符串，可选）：分析的附加上下文

使用示例：

// Called by Claude Code sub-agent
gemini_targeted_analysis({
  workingDir: "/path/to/your/project",
  targetPaths: ["src/api/", "src/controllers/auth.js"],
  analysisContext: "Security review of authentication components"
})

Claude代码集成

子代理使用

这 gemini-code-analyzer 一旦配置了MCP服务器，子代理在Claude Code中就会自动可用。

命令示例：

• “请分析整个代码库的架构问题”
• “检查src/auth/中的身份验证模块是否存在安全漏洞”
• “分析src/controllers/中的API终结点的性能瓶颈”

手动工具访问

您还可以直接通过Claude Code的工具界面调用MCP工具：

1. 使用 /tools 查看可用的MCP工具
2. 选择 gemini_comprehensive_review 或 gemini_targeted_analysis
3. 提供所需参数

发展

以开发模式运行

npm run dev

生产大楼

npm run build
npm start

项目结构

gemini-cli-mcp/
├── src/
│   ├── server.ts              # Main MCP server
│   ├── tools/                 # MCP tool implementations
│   │   ├── comprehensive-review.ts
│   │   └── targeted-analysis.ts
│   └── utils/                 # Utility functions
│       ├── code2prompt-executor.ts
│       └── gemini-executor.ts
├── prompts/                   # Prompt templates
│   ├── comprehensive-review.md
│   └── targeted-analysis.md
├── dist/                      # Built TypeScript output
└── package.json

故障排除

常见问题

“找不到gemini命令”

确保Gemini CLI已安装并位于PATH中：

npm install -g @google/gemini-cli
which gemini

“未找到code2prompt命令”

安装代码2提示：

cargo install code2prompt
# or
brew install mufeedvh/tap/code2prompt

身份验证问题

使用Gemini CLI重新进行身份验证：

gemini
# Follow OAuth prompts again

MCP服务器未连接

1. 检查Claude Code MCP设置配置
2. 验证服务器路径是否正确
3. 检查控制台日志是否有错误
4. 配置更改后重新启动Claude代码

日志记录

MCP服务器登录到stderr。运行时监视日志：

npm run dev

配置选项

不包括文件/图案

综合审查自动排除常见模式：

• node_modules/**
• .git/**
• *.log
• dist/**, build/**
• .next/**
• coverage/**

通过添加自定义排除项 excludePatterns 参数。

许可证管理

• code2prompt为大型代码库提供令牌计数
• Gemini CLI自动处理1M令牌上下文窗口
• 通过code2prompt的优化，可以高效地处理大型代码库

安全考虑

• 使用现有的Gemini CLI OAuth身份验证
• MCP服务器中未存储API密钥
• 代码库内容被发送到Gemini进行分析
• 在分析专有代码时考虑数据敏感性

许可证

MIT许可证-有关详细信息，请参阅许可证文件