Gemini Grounding MCP Server
一个MCP（模型上下文协议）服务器，使用Google Gemini的接地功能提供实时信息访问。此服务器使MCP兼容客户端能够使用Gemini内置的Google搜索基础搜索当前信息、开发人员资源、文档和Reddit讨论。
❓ 为什么？
当使用像Claude Code这样的人工智能助手时，您通常需要超出模型知识边界的最新信息和社区见解。Claude Code拒绝搜索Reddit，并且对访问实时信息有限制。
此MCP服务器通过利用Gemini的基础功能绕过了这些限制，该功能可以搜索网络和其他来源，直接在您的AI工作流程中提供当前信息、代码示例、讨论和社区见解。
✨ 特性
- 🔍 实时搜索：通过Gemini的谷歌搜索基础访问当前信息
- 👨💻 以开发人员为中心：用于搜索代码示例、文档和故障排除的工具
- 💬 Reddit集成：搜索Reddit讨论和社区见解
- 📚 自动引用：源链接和归因由Gemini自动提供
- 🔗 多源合成：合并来自多个网络源的信息
- 🎯 上下文感知：基于编程语言和框架的定制搜索结果
- ✅ 事实核查：内置事实检查和准确性验证
📦 安装
先决条件
- Node.js 18+
- Google Gemini API密钥 从 谷歌人工智能工作室
选项1：与npx一起使用
npx gemini-grounding选项2：从源代码构建
git clone https://github.com/epilande/gemini-grounding.git
cd gemini-grounding
pnpm install
pnpm build获取Gemini API密钥
- 访问 谷歌人工智能工作室
- 创建或选择项目
- 生成API密钥
- 将密钥添加到您的
.env文件
🎮 用法
此服务器可与任何兼容MCP的客户端配合使用。
克劳德代码
使用以下命令将此服务器添加到您的Claude Code MCP配置中 claude mcp add 命令：
claude mcp add gemini-grounding -e GEMINI_API_KEY="${GEMINI_API_KEY}" -- npx -y gemini-grounding或者手动添加到您的配置中：
{
"mcpServers": {
"gemini-grounding": {
"command": "npx",
"args": ["-y", "gemini-grounding"],
"env": {
"GEMINI_API_KEY": "${GEMINI_API_KEY}"
}
}
}
}验证
添加到配置后：
- 重新启动MCP客户端（例如，Claude Code）
- 打开新对话
- 在工具选择器中查找Gemini接地工具
- 使用以下查询进行测试：
- "Why is neovim the best editor? Search reddit" - "What are the new Go lang features?" - "Latest docs for React hooks" - "What are useEffect dependency array best practices"
🛠️ 工具
search_with_grounding
具有双子座接地功能的通用搜索。
参数：
query（必填）：搜索查询context（可选）：开发背景或附加信息focus（可选）：焦点区域-"general","code","documentation"，或"troubleshooting"
search_developer_resources
专门搜索开发人员资源和文档。
参数：
query（必填）：技术查询language（可选）：编程语言（例如。，JavaScript,Python,Rust)framework（可选）：框架或库（例如。，React,Express,Django)
search_documentation
搜索官方文档和API参考资料。
参数：
query（必填）：文件查询technology（可选）：技术、框架或工具名称
search_reddit
搜索Reddit讨论和社区见解。
参数：
query（必填）：Reddit内容的搜索查询subreddit（可选）：要搜索的特定子版块（例如。，"programming","reactjs")
🏗️ 建筑
┌─────────────────────────────────────┐
│ MCP-Compatible Client │
│ • Claude Code, Cursor, etc. │
│ • File editing & bug fixing │
│ • Codebase analysis │
│ • Development workflows │
└─────────────┬───────────────────────┘
│ MCP Integration
┌─────────────▼───────────────────────┐
│ Node.js Grounding Agent Service │
│ • Query routing & analysis │
│ • Context management │
│ • Response formatting │
└─────────────┬───────────────────────┘
│ Single API Call
┌─────────────▼───────────────────────┐
│ Gemini 2.5 Flash │
│ • Google Search grounding │
│ • Real-time information access │
│ • Automatic source citation │
│ • Multi-source synthesis │
└─────────────────────────────────────┘🔧 发展
# Development mode
pnpm dev
# Build
pnpm build
# Production
pnpm start🐛 故障排除
常见问题
服务器无法以“需要GEMINI_API_KEY环境变量”启动
- 确保您已创建
.env使用API密钥文件 - 或者在MCP配置中传递API键
env章节 - 在验证您的API密钥是否有效 谷歌人工智能工作室
MCP客户端中未显示工具
- 检查配置中的文件路径是否绝对正确
- 更改配置后重新启动MCP客户端
- 使用验证服务器构建是否成功
pnpm build - 检查客户的日志是否有任何错误消息
“找不到模块”错误
- 跑
pnpm install确保所有依赖项都已安装 - 确保你使用的是Node.js 18或更高版本
- 尝试删除
node_modules跑步pnpm install再次
搜索请求失败或超时
- 验证Gemini API密钥是否剩余配额
- 检查您的互联网连接
- 确保Gemini API服务可从您的网络访问