Gemini MCP Server

Gemini MCP 服务

本项目实现了一个用于 Google Search 的 Model Context Protocol（MCP）服务，可与 AI 助手及其他兼容 MCP 的客户端集成。

---

前提条件

• Node.js 18+
• npm

---

安装

1. 克隆仓库

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

2. 安装依赖项

npm install

3. 设置 Google Custom Search API 凭据

在项目根目录中创建 .env 文件，并写入以下内容：

GEMINI_API_KEY=your_google_api_key_here

• GOOGLE_API_KEY：你的 Google Custom Search API 密钥。

你可以通过 Google Custom Search JSON API 文档获取这些信息。

---

使用方法

1. 运行测试搜索

npx ts-node src/test.ts

这将执行示例搜索，并在控制台中打印结果。

2. 与兼容 MCP 的客户端集成

要将此服务用作 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",
      }
    }
  }
}

将 API 密钥和 CX ID 替换为你的实际凭据。

---

可用工具

该服务提供以下工具：

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

有关详细用法，请参阅 src/tools.ts 中的源代码。

---

开发

要修改此项目：

1. 根据需要修改 src 目录中的代码。
2. 如果添加或移除依赖项，请相应更新 package.json。
3. 重启 MCP 客户端或测试脚本以应用更改。

---

故障排除

• 确保已在 .env 文件或环境中正确设置 Google API 密钥和 CX ID。
• 检查是否已安装所有依赖项（npm install）。
• 确认使用的是 Node.js 18 或更高版本。
• 如果修改了代码，请重启服务或测试脚本。

---

许可证

本项目采用 MIT License 许可。