MCP Gemini Web

MCP Gemini 网络搜索

一个模型上下文协议（MCP）服务器，提供由Google的Gemini 2.5 Flash和Google搜索基础能力支持的可靠网络搜索功能。

特点/功能

• 单身 web_search 工具 具有双模式：

- normal快速、单步接地搜索 - research多步骤研究，包括查询规划→执行→综合

• 谷歌搜索定位 为了准确的、已引用的结果
• 带有主观意见的系统指令 对于API/库查询，应优先参考官方文档
• 可配置的模型和终端节点

安装

通过 npx（推荐）

npx -y mcp-gemini-web

通过 npm 安装

npm install -g mcp-gemini-web
mcp-gemini-web

环境变量

• GEMINI_API_KEY 或者 GOOGLE_API_KEY必填项 - 您的Google AI API密钥
• GENAI_BASE_URL 或者 GEMINI_BASE_URL可选 - 自定义API端点
• MODEL可选 - 要使用的模型（默认： gemini-2.5-flash)

MCP客户端配置

Claude Desktop（可译为“Claude桌面版”或根据上下文简化为“Claude桌面”）

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-web": {
      "command": "npx",
      "args": ["-y", "mcp-gemini-web"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

其他MCP客户端

服务器通过stdio使用MCP协议进行通信。请配置您的客户端以运行：

npx -y mcp-gemini-web

使用示例

常规搜索（快速）

{
  "tool": "web_search",
  "arguments": {
    "q": "what is Node.js 22 LTS",
    "mode": "normal"
  }
}

研究模式（深入）

{
  "tool": "web_search",
  "arguments": {
    "q": "compare axios vs fetch for production Node.js usage",
    "mode": "research", 
    "max_steps": 4
  }
}

工具参数

• q （字符串，必填）：搜索查询
• mode (枚举，可选)：搜索模式 - "normal" （默认）或 "research"
• model （字符串，可选）：要使用的Gemini模型
• max_tokens （数字，可选）：最大输出标记数（64-8192）
• max_steps （数字，可选）：研究模式下的最大研究步骤（1-6，默认：3）

发展

# Clone and install
git clone 
cd mcp-gemini-web
npm install

# Development mode
npm run dev

# Build
npm run build

# Test
npm test

# Start built version
npm start

许可证

麻省理工学院（MIT）

贡献；做出贡献

欢迎提交拉取请求！请确保测试通过，并遵循现有的代码风格。