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

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

🚀 快速开始

克隆仓库

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

安装依赖项

npm install

创建.env 文件

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

构建服务器

npm run build

启动服务器

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 提供）

💻 使用示例

搜索工具

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

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

响应将包含以下结构：

📚 详细文档

配置

环境变量

Claude Desktop 集成

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

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

项目结构

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

可用脚本

📄 许可证

[许可证链接]

🙏 致谢

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