remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables web search capabilities through Google's Custom Search API, allowing users to retrieve search results with titles, URLs, and descriptions.
Uses Google Cloud's Custom Search API to perform web searches with configurable results (up to 10 per query).

MCP Google 自定义搜索服务器

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

🌟 功能

与 Google 自定义搜索 API 无缝集成
符合模型上下文协议 (MCP) 的服务器实现
使用 TypeScript 的类型安全实现
环境变量配置
使用 Zod 进行输入验证
可配置的搜索结果（每个查询最多 10 个）
格式化的搜索结果，包括标题、URL 和描述
错误处理和验证
与 Claude Desktop 和其他 MCP 客户端兼容

📋 先决条件

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

启用了自定义搜索 API 的 Google Cloud 项目
- 访问Google Cloud Console
- 启用自定义搜索 API
- 创建 API 凭证
自定义搜索引擎 ID
- 访问可编程搜索引擎
- 创建新的搜索引擎
- 获取您的搜索引擎 ID
当地发展要求：
- Node.js（v18 或更高版本）
- npm（Node.js 附带）

🚀 快速入门

克隆存储库：
git clone https://github.com/yourusername/mcp-google-custom-search-server.git cd mcp-google-custom-search-server
安装依赖项：
npm install
创建 .env 文件：
GOOGLE_API_KEY=your-api-key GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id
构建服务器：
npm run build
启动服务器：
npm start

🔧 配置

环境变量

多变的	描述	必需的
GOOGLE_API_KEY	您的 Google 自定义搜索 API 密钥	是的
GOOGLE_SEARCH_ENGINE_ID	您的自定义搜索引擎 ID	是的

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 ：用于开发的监视模式

测试

使用 MCP 检查器：
npx @modelcontextprotocol/inspector node build/index.js
使用示例查询进行手动测试：
# After starting the server {"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"search","arguments":{"query":"example search"}}}

📝 许可证

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

🙏 致谢

使用模型上下文协议（MCP）构建
使用 Google 的自定义搜索 API
受到 LLM 应用程序中对更好的搜索功能的需求的启发

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search

模型上下文协议服务器使 LLM 能够通过标准化界面使用 Google 的自定义搜索 API 执行网络搜索。

Related Resources

Reddit Discussion about this server

MCP Google Custom Search Server