Gemini MCP Server

基本能力

产品定位

Gemini MCP Server 是一个为 Google 搜索实现的模型上下文协议（MCP）服务器，旨在与 AI 助手和其他 MCP 兼容的客户端集成。

核心功能

1. googleSearchContent: 使用 Google Custom Search API 进行网页搜索，并返回结构化的结果（标题、链接和摘要）。
2. googleSearchImages: 使用 Google Custom Search API 进行图片搜索，并返回第一个结果的 Markdown 图片链接。

适用场景

1. 集成到 AI 助手中，提供实时搜索功能。
2. 作为 MCP 兼容客户端的一部分，增强其搜索能力。
3. 开发需要搜索功能的应用程序或服务。

工具列表

1. googleSearchContent: 提供网页搜索功能，返回结构化数据。
2. googleSearchImages: 提供图片搜索功能，返回图片链接。

常见问题解答

1. API 密钥问题: 确保 Google API 密钥和 CX ID 正确设置在 .env 文件或环境中。
2. 依赖问题: 检查所有依赖是否已安装（npm install）。
3. Node.js 版本问题: 确认使用 Node.js 18 或更新版本。
4. 代码更改问题: 如果修改了代码，需要重启服务器或测试脚本。

使用教程

使用依赖

• Node.js 18+
• npm

安装教程

1. 克隆仓库

git clone https://github.com/your-username/mcp-google-search.git
cd google-mcp-server

1. 安装依赖

npm install

1. 设置 Google Custom Search API 凭证 在项目根目录创建 .env 文件，内容如下：

GEMINI_API_KEY=your_google_api_key_here

调试方式

1. 运行测试搜索

npx ts-node src/test.ts

1. 与 MCP 兼容客户端集成 在 MCP 设置文件（如 claude_desktop_config.json）中添加以下内容：

{
  "mcpServers": {
    "gemini-api": {
      "command": "npx",
      "args": ["ts-node", "src/index.ts"],
      "env": {
        "GEMIN_API_KEY": "your_gemini_api_key_here",
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。