MCP Google Custom Search Server

🚀 MCP 谷歌自定义搜索服务器

MCP 谷歌自定义搜索服务器是一个模型上下文协议（MCP）服务器，借助谷歌的自定义搜索 API 为语言学习模型（LLMs）提供网络搜索功能。它通过标准化接口，让 LLMs 可以便捷地执行网络搜索。

🚀 快速开始

1. 克隆仓库：

git clone https://github.com/yourusername/mcp-google-custom-search-server.git
cd mcp-google-custom-search-server

2. 安装依赖项：

npm install

3. 创建 .env 文件：

GOOGLE_API_KEY=你的API密钥
GOOGLE_SEARCH_ENGINE_ID=你的搜索引擎ID

4. 构建服务器：

npm run build

5. 启动服务器：

npm start

✨ 主要特性

• 与谷歌自定义搜索 API 无缝集成
• 符合模型上下文协议（MCP）的服务器实现
• 使用 TypeScript 实现安全类型
• 支持通过环境变量进行配置
• 利用 Zod 进行输入验证
• 可对搜索结果进行配置（最多每条查询 10 个）
• 搜索结果会进行格式化，包含标题、URL 和描述
• 具备错误处理和验证机制
• 与 Claude Desktop 及其他 MCP 客户端兼容

📦 安装指南

先决条件

在开始之前，请确保您有：

1. 一个启用自定义搜索 API 的谷歌云项目
   • 访问 谷歌云控制台
   • 启用自定义搜索 API
   • 创建 API 凭证
2. 自定义搜索引擎 ID
   • 访问 可编程搜索引擎
   • 创建一个新的搜索引擎
   • 获取您的搜索引擎 ID
3. 本地开发要求：
   • Node.js（v18 或更高版本）
   • npm（随 Node.js 提供）

🔧 技术细节

环境变量

Claude Desktop 集成

将此配置添加到您的 Claude Desktop 配置文件中（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "googleCustomSearchMCP": {
      "url": "http://localhost:3000",
      "id": "your-server-id"
    }
  }
}

📚 详细文档

搜索工具

要执行搜索，请向 /search 端点发送 POST 请求：

{
  "queries": ["你的搜索查询"]
}

响应将包含以下结构：

项目结构

mcp-google-custom-search-server/
├── src/
│   ├── server.ts          # 主服务器文件
│   └── search.ts         # 搜索处理逻辑
└── package.json        # 项目依赖和脚本

可用脚本

📄 许可证

[许可证链接]

🙏 致谢

感谢您使用我们的 MCP 自定义搜索服务器。如果有任何问题或建议，请随时与我们联系。