内容
free-search-mcp-geminicli
一款通过 [](https://github.com/google-gemini/gemini-cli 搜索功能，为任何 AI 代理提供严格的、引用明确搜索的 MCP 服务器。
```
┌──────────────┐ STDIO ┌──────────────────┐ 子进程 ┌────────────│ AI 代理 │◄──────────────►│ -search │──────────────────►│ Gemini CLI │
│ （任意 │ JSON-RPC │ MCP 服务器 │ gemini-3-flash │ Google 网络 │
│ 客户端） └──────────────────┘ -预览 │ 搜索 │
└──────────────┘ └─────────────┘
```
## 为什么？
程助手（Claude、Kilo Code、Cursor 等）功能 **对实时网络不可见**。这个 MCP 服务器通过 Gemini CLI 进行查询，从而解决了这个问题，Gemini CLI 具有内置的 Google 搜索基础功能 —— 这意味着每个响应都由具有引用的实时网络结果支持。
使用这个而不是其他付费搜索 MCP？**
- **100% 无限制**（依赖于您的本地 Google Cloud SDK / Gemini CLI- **高质量**（使用 Google 的实时搜索索引和 `-3-flash-preview` 模型）
- **无需配置 API 。如果 Gemini CLI 在您的机器上运行，则此服务器也运行 工具
| 工具 | 描述 | 超时时间 |
|:------------|:--------|
| `web_search` | 快速的事实带有来源三角定位和置信度评分 | 90秒 |
deep_research` | 7 步研究协议，带有证据分级/B/C/D] 和反对观点分析 | 180秒 |
| `fact_check` | 法医 5 阶段验证流程，带有声明分解和精度审计 | 90秒 |
## 先决条件
- **Node.js** ≥ 18
- **Gemini CLI** 已安装并认证（`npm install -g @google/gemini-cli`）
- 支持 **Windows**、**macOS** 和 **Linux**
## 安装
```bash
git clone https://github.com/leacvikas0/free-search-meminicli.git
cd free-search-mcp-geminicli
npm install
```
## 设置
添加到您的 MCP 客户端配置中： Claude Desktop / Antigravity / 通用 MCP 客户端
```json
{
"mcpServers": {
"gemini-search": {
"command": "node",
"args": ["/绝对路径/to/free-search-mcp-geminicli/server.js"],
"env": {}
}
}
}
```
### Kilo Code（VS Code）
MCP 配置 → 编辑全局 MCP```json
{
"Servers": {
"gemini-search": {
"command": "node",
"args": ["/绝对路径/to/free-search-mcp-geminicli/server.js"],
"env": {},
"trust": true
}
}
}
```
### Cursor
添加到项目中的 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"gemini-search": {
"command": "node",
"args": ["/绝对路径/to/free-search-mcp-geminicli/server.js"]
}
}
```
原理
1. 您的 AI 代理调用一个 MCP 工具（例如 `web_search`）
2. 服务器将查询写入一个临时文件，并将其通过管道传递给ini -m gemini-3-flash-preview --output-format json`
3. Gemini CLI 使用其内置的 `google_web_search` 基础功能搜索实时网络
4. 服务器解析 JSON 响应并返回干净的、引用明确的结果
5. 您的 AI 代理获得可靠的的网络研究
每个工具都有一个精心设计的系统，强制执行：
- **来源三角定位** — 从 2 个以上独立来源验证声明
- **反幻觉规则** — 绝不伪造 URL、统计数据或引用
- **证据分级** — [ 至 [D] 评级，评估声明的可信度
- **冲突检测** — 揭示来源之间的分歧，而不是隐藏它们
## 配置
默认情况下，模型设置为 `gemini-3-flash-preview`。要更改它，请
