AI搜索与文档分析服务

Gemini MCP服务器：免费人工智能搜索和VS代码接地

开源困惑替代方案 对于开发者来说。将VS Code Copilot、Cline或Roo连接到 谷歌搜索 和 深层网络分析 通过模型上下文协议（MCP）。

📖 目录

• 为什么要用这个？
• 原理
• 主要特点
• 可用工具
• 快速开始
• 配置
• 比较
• 故障排除

为什么使用Gemini MCP服务器？

这是一个 模型上下文协议（MCP）服务器 升级你的AI编码助手（比如 VS代码GitHub副本Cline或Roo Code）。它提供实时互联网接入和深度网页分析，使用 谷歌Gemini 2.5 Flash API.

使用 谷歌搜索暂停，使您的法学硕士能够从网络上获取事实答案，而不会产生幻觉。

优点：

• IDE中的困惑： 问“Next.js 15的最新突破性变化是什么？”并在不离开VS Code的情况下获得引用答案。
• 免费运行： 使用Google AI Studio免费版(1500次请求/天).
• 深层背景： 不只是阅读片段；它使用Gemini的 url_context 阅读完整的文档页面、PDF和技术博客。

工作原理（接地架构）

graph LR
    A[User in VS Code] -->|Asks Question| B(Copilot / MCP Client);
    B -->|Routes Query| C[Gemini MCP Server];
    C -->|API Call| D[Gemini API];
    D -->|1. Search & Retrieve| E[Google Search / Web Index];
    D -->|2. Augment Context| D;
    D -->|3. Generate Answer| B;
    B -->|Final Answer| A;

主要特点

• 🔍 使用谷歌搜索： 使用官方 谷歌搜索暂停 获取最新的事实性结果。
• 📄 深度URL分析： 使用Gemini的 URL上下文 阅读大型文档（HTML、PDF）进行摘要和质量保证。
• 📚 引文和来源： 每个声明都有一个可点击的链接作为支持，将其与标准的LLM幻觉区分开来。
• 🎯 预配置提示： 用于常见研究和分析任务的现成模板。
• 📊 资源访问： 动态查询服务器功能和信息。
• ✅ 标准MCP协议： 与任何MCP客户端兼容，包括 光标, 帆板运动，以及 VS Code.
• ⚡ 低延迟： 由...驱动 gemini-2.5-flash，针对速度和低成本进行了优化。
• 🆓 100%免费等级： 使用免费的Google AI Studio API密钥（无需信用卡）。

可用工具

可用提示

预先配置的提示，使常见任务更容易：

可用资源

快速开始

1.克隆存储库

git clone https://github.com/nav9v/gemini-search-mcp.git
cd gemini-mcp-server

2.设置Python环境

python -m venv .venv
# Activate virtual environment
# Windows:
.venv\Scripts\Activate.ps1
# Mac/Linux:
source .venv/bin/activate

pip install -r requirements.txt

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3.获取您的免费API密钥

1. 首选 Google AI 工作室.
2. 创建一个 免费API密钥 （无需信用卡）。
3. 创建一个 .env 根目录中的文件：

GEMINI_API_KEY=your_actual_api_key_here
GEMINI_MODEL=gemini-2.5-flash

4.添加到VS代码

编辑MCP配置文件：

• 窗户： %APPDATA%\Code\User\mcp.json
• Mac/Linux： ~/Library/Application Support/Code/User/mcp.json

选项1：使用工作目录（推荐）

{
  "mcpServers": {
    "gemini-search": {
      "command": "python",
      "args": ["gemini_search_mcp.py"],
      "cwd": "C:/absolute/path/to/gemini-search-mcp",
      "env": {
        "PYTHONPATH": "C:/absolute/path/to/gemini-search-mcp"
      }
    }
  }
}

选项2：使用虚拟环境

{
  "mcpServers": {
    "gemini-search": {
      "command": "C:/absolute/path/to/.venv/Scripts/python.exe",
      "args": ["C:/absolute/path/to/gemini_search_mcp.py"]
    }
  }
}

注：

• 替换 C:/absolute/path/to/ 包含克隆文件夹的完整路径
• 使用正斜杠(/)或双反睫毛(\\)在路径
• 服务器加载 .env 自动，所以你不需要 env 如果使用，请阻止 .env
• 看 mcp.json.示例 对于模板

5.重新加载VS代码

按 Ctrl+Shift+P → 开发者：重新加载窗口.

💬 使用示例

直接使用工具

打开 副驾驶聊天 （或您的MCP客户）并询问：

• “搜索Next.js 15的最新突破性更改。” （触发器 search)
• “分析此页面：https://docs.python.org/3/whatsnew/3.13.html" （触发器 analyze_url)
• “2026年，Vercel的最佳开源替代品是什么？”
• “阅读文档https://fastapi.tiangolo.com/并解释如何使用依赖注入。"

使用提示（推荐）

提示为常见任务提供结构化模板：

• 网络搜索： 使用 web-search 用主题提示
• 文件分析： 使用 analyze-documentation 带有URL的提示
• 研究： 使用 research-topic 促进全面研究
• 比较： 使用 compare-technologies 提示比较工具/框架

VS代码副本示例：

@gemini-search #web-search topic="Python async best practices 2026"

配置

所有配置均通过 .env 在项目根目录中：

支持的型号

*在免费等级限制后支付。

💰 定价

完全免费。

1. 谷歌人工智能工作室API： 免费套餐包括 每天1500个请求.
2. 该软件： 开源（麻省理工学院）。

无需信用卡。非常适合个人开发人员、学生和原型制作人员。

🆚 比较

*在本地运行，将查询发送到Google Gemini API。

🛠 故障排除

# Activate virtual environment first
.venv\Scripts\Activate.ps1

# Run the server
python gemini_search_mcp.py

贡献

欢迎拉取请求！请将代码格式化为 black 并确保严格打字。

许可证

麻省理工学院 ©2026 Navneet Sharma