网络搜索工具

一个基于Google Gemini 2.5 Flash和Google Search的模型上下文协议(MCP)服务器,提供基于网络的搜索能力。

  • by deduble
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 deduble/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 <repository-url>
cd mcp-gemini-web
npm install

# Development mode
npm run dev

# Build
npm run build

# Test
npm test

# Start built version
npm start

许可证

麻省理工学院(MIT)

贡献;做出贡献

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