MCP Google 自定义搜索服务器

一个模型上下文协议 (MCP) 服务器，通过 Google 的自定义搜索 API 提供网页搜索功能。该服务器支持语言学习模型 (LLM) 使用标准化接口执行网页搜索。

🌟 功能

• 与 Google 自定义搜索 API 无缝集成

• 符合模型上下文协议 (MCP) 的服务器实现

• 使用 TypeScript 的类型安全实现

• 环境变量配置

• 使用 Zod 进行输入验证

• 可配置的搜索结果（每个查询最多 10 个）

• 格式化的搜索结果，包括标题、URL 和描述

• 错误处理和验证

• 与 Claude Desktop 和其他 MCP 客户端兼容

Related MCP server: MCP Server for Google Search

📋 先决条件

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

1. 启用了自定义搜索 API 的 Google Cloud 项目

   • 访问Google Cloud Console

   • 启用自定义搜索 API

   • 创建 API 凭证

2. 自定义搜索引擎 ID

   • 访问可编程搜索引擎

   • 创建新的搜索引擎

   • 获取您的搜索引擎 ID

3. 当地发展要求：

   • Node.js（v18 或更高版本）

   • npm（Node.js 附带）

🚀 快速入门

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=your-api-key
   GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id

4. 构建服务器：

   npm run build

5. 启动服务器：

   npm start

🔧 配置

环境变量

Claude 桌面集成

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

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-google-custom-search-server/build/index.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
      }
    }
  }
}

📖 API 参考

可用工具

搜索

使用 Google 自定义搜索 API 执行网络搜索。

参数：

• query （字符串，必需）：要执行的搜索查询

• numResults （数字，可选）：要返回的结果数

  • 默认值：5

  • 最大：10

响应示例：

Result 1:
Title: Example Search Result
URL: https://example.com
Description: This is an example search result description
---

Result 2:
...

🛠️ 开发

项目结构

mcp-google-custom-search-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript output
├── .env                  # Environment variables
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # Project documentation

可用脚本

• npm run build ：将 TypeScript 编译为 JavaScript

• npm start ：启动 MCP 服务器

• npm run dev ：用于开发的监视模式

测试

1. 使用 MCP 检查器：

   npx @modelcontextprotocol/inspector node build/index.js

2. 使用示例查询进行手动测试：

   # After starting the server
   {"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"search","arguments":{"query":"example search"}}}

📝 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• 使用模型上下文协议（MCP）构建

• 使用 Google 的自定义搜索 API

• 受到 LLM 应用程序中对更好的搜索功能的需求的启发