金大哥 - MCP Google Custom Search Server MCP 详情

article

README

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

MCP 谷歌自定义搜索服务器是一个模型上下文协议（MCP）服务器，借助谷歌的自定义搜索 API 为语言学习模型（LLMs）提供网络搜索功能。它通过标准化接口，让 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 客户端兼容

📦 安装指南

先决条件

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

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

🔧 技术细节

环境变量

| 属性 | 详情 | |------|------| | GOOGLE_API_KEY | 您的谷歌自定义搜索 API 密钥 | | GOOGLE_SEARCH_ENGINE_ID | 您的自定义搜索引擎 ID |

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": ["你的搜索查询"]
}

响应将包含以下结构： | 属性 | 详情 | |------|------| | title | 结果标题 | | url | 结果链接 | | content | 简要描述 |

项目结构

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

可用脚本

| 属性 | 详情 | |------|------| | npm start | 启动服务器 | | npm build | 构建生产文件 | | npm test | 运行测试 |

📄 许可证

[许可证链接]

🙏 致谢

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

MCP Google Custom Search Server