MCP Google Server

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

  • Allows performing web searches using Google Custom Search API, returning structured results with title, link, and snippet.

mcp-google-server 用于 Google 自定义搜索和网页阅读的 MCP 服务器

使用 Google 自定义搜索 API 和网页内容提取功能提供网络搜索功能的模型上下文协议服务器。

设置

获取 Google API 密钥和搜索引擎 ID

  1. 创建 Google Cloud 项目:
  2. 启用自定义搜索 API:
    • 前往API 库
    • 搜索“自定义搜索 API”
    • 点击“启用”
  3. 获取 API 密钥:
    • 前往凭证
    • 点击“创建凭证”>“API 密钥”
    • 复制您的 API 密钥
    • (可选)将 API 密钥限制为仅限自定义搜索 API
  4. 创建自定义搜索引擎:
    • 前往可编程搜索引擎
    • 输入您要搜索的网站(使用www.google.com进行常规网页搜索)
    • 点击“创建”
    • 在下一页上,点击“自定义”
    • 在设置中,启用“搜索整个网络”
    • 复制您的搜索引擎 ID (cx)

发展

安装依赖项:

npm install

构建服务器:

npm run build

对于使用自动重建的开发:

npm run watch

特征

搜索工具

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

  • 搜索整个网络或特定网站
  • 控制结果数量(1-10)
  • 通过标题、链接和摘要获取结构化结果

网页阅读器工具

从任何网页提取内容:

  • 获取并解析网页内容
  • 提取页面标题和正文
  • 通过删除脚本和样式来清理内容
  • 返回包含标题、文本和 URL 的结构化数据

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Google 自定义搜索服务器:

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

要与 Claude Desktop 一起使用,请使用您的 Google API 凭据添加服务器配置:

在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "google-search": { "command": "npx", "args": [ "-y", "@adenot/mcp-google-search" ], "env": { "GOOGLE_API_KEY": "your-api-key-here", "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here" } } } }

用法

搜索工具

{ "name": "search", "arguments": { "query": "your search query", "num": 5 // optional, default is 5, max is 10 } }

网页阅读器工具

{ "name": "read_webpage", "arguments": { "url": "https://example.com" } }

网页读者的回应示例:

{ "title": "Example Domain", "text": "Extracted and cleaned webpage content...", "url": "https://example.com" }

调试

由于 MCP 服务器通过 stdio 进行通信,调试起来可能比较困难。我们推荐使用MCP Inspector ,它以包脚本的形式提供:

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

使用 Google 自定义搜索 API 提供网络搜索功能,使用户能够通过模型上下文协议服务器执行搜索。

  1. Setup
    1. Getting Google API Key and Search Engine ID
  2. Development
    1. Features
      1. Search Tool
      2. Webpage Reader Tool
    2. Installation
      1. Installing via Smithery
    3. Usage
      1. Search Tool
      2. Webpage Reader Tool
      3. Debugging
    ID: 05vc0lafp9