Google 自定义搜索引擎 MCP 服务器

一个模型上下文协议服务器，使用 CSE（自定义搜索引擎）提供搜索功能。该服务器使 LLM 能够提供常规的 Google 搜索词并返回找到的搜索结果。

该工具仅返回结果本身，不包含内容。建议将其与其他服务器（例如mcp-server-fetch）结合使用，以便从搜索结果中提取内容。您也可以将其与其他工具结合使用，以实现某种“深度搜索”或工具链式功能。

免费配额为每天 100 次搜索（1 次工具调用 == 1 次搜索），如果您不想设置计费并且这不足以满足您的使用情况，您应该考虑使用其他服务器。

可用工具

google_search - 使用搜索词搜索自定义搜索引擎并返回包含每个结果的标题、链接和片段的结果列表。
- search_term （字符串，必需）：要搜索的搜索词，相当于通常的 Google 搜索中的查询参数q 。

环境变量

API_KEY （必需）：自定义搜索引擎的 API 密钥。
ENGINE_ID （必需）：自定义搜索引擎的引擎 ID。
SERVICE_NAME （必需/可选）：服务名称，如果您没有更改名称（自定义搜索），则留空。
COUNTRY_REGION （可选）：将搜索结果限制为来自特定国家/地区的文档。请参阅国家/地区参数值以了解有效值。
GEOLOCATION （可选，默认为“us”）：执行搜索的最终用户的地理位置。请参阅地理位置参数值以了解有效值。
RESULT_LANGUAGE （可选，默认为“lang_en”）：搜索结果的语言。请参阅自定义搜索引擎查询参数 lr了解有效值。
RESULT_NUM （可选，默认 10）：返回的搜索结果数量。范围为 1-10。

CSE 设置

创建自定义搜索引擎相对容易，完全免费，并且可以在 5 分钟内完成。

前往https://console.cloud.google.com/并创建一个新项目。例如，命名为“Claude CSE”。
选择项目并在搜索栏中搜索“自定义搜索 API”。
点击搜索结果，点击“启用”。
单击“凭据”选项卡并创建一个新的 API 密钥。
前往https://programmablesearchengine.google.com创建一个新的自定义搜索引擎。
创建一个新的搜索引擎并赋予它任意名称，该名称与SERVICE_NAME无关。
如果您想要正常的 Google 搜索体验，请选择“搜索整个网络”。
单击“创建”并从 js 代码中复制引擎 ID，或点击自定义并从概览中获取它。
您可以根据自己的喜好随意定制搜索引擎。

使用默认配额，您每天可免费获得 100 次搜索。例如，即使您获得 10 条结果，每次工具调用也仅需支付 1 次搜索的费用。

安装

使用 uv（推荐）

使用uv时无需特殊安装。我们将使用uvx直接运行mcp-google-cse 。

使用 PIP

或者，您可以通过 pip 安装mcp-google-cse ：

pip install mcp-google-cse

安装后，您可以使用以下命令将其作为脚本运行：

python -m mcp-google-cse

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Google 自定义搜索引擎：

npx -y @smithery/cli install @Richard-Weiss/mcp-google-cse --client claude

配置

为 Claude 应用程序配置

添加到您的claude_desktop_config.json ：

使用 uvx（如果你不知道选择哪一个，请使用这个）

"mcp-google-cse": {
    "command": "uvx",
    "args": ["mcp-google-cse"],
    "env": {
        "API_KEY": "",
        "ENGINE_ID": ""
    }
}

使用 pip 安装

"mcp-google-cse": {
    "command": "python",
    "args": ["-m", "mcp-google-cse"],
    "env": {
        "API_KEY": "",
        "ENGINE_ID": ""
    }
}

本地运行

    "mcp-google-cse": {
      "command": "uv",
      "args": [
        "--directory",
        "{{Path to the cloned repo",
        "run",
        "mcp-google-cse"
      ],
      "env": {
        "API_KEY": "",
        "ENGINE_ID": ""
      }
    }

示例结果

google_search("2024-11-01 之后的 MCP 是什么") 结果：

[
    {
        "title": "Can someone explain MCP to me? How are you using it? And what ...",
        "link": "https://www.reddit.com/r/ClaudeAI/comments/1h55zxd/can_someone_explain_mcp_to_me_how_are_you_using/",
        "snippet": "Dec 2, 2024 ... Comments Section ... MCP essentially allows you to give Claude access to various external systems. This can be files on your computer, an API, a browser, a ..."
    },
    {
        "title": "Introducing the Model Context Protocol \\ Anthropic",
        "link": "https://www.anthropic.com/news/model-context-protocol",
        "snippet": "Nov 25, 2024 ... The Model Context Protocol (MCP) is an open standard for connecting AI assistants to the systems where data lives, including content repositories, ..."
    },
    {
        "title": "3.5 Sonnet + MCP + Aider = Complete Game Changer : r ...",
        "link": "https://www.reddit.com/r/ChatGPTCoding/comments/1hwn6qd/35_sonnet_mcp_aider_complete_game_changer/",
        "snippet": "Jan 8, 2025 ... Really cool stuff. For those out of the loop here are some MCP servers. You can give your Claude chat (in the desktop version, or in a tool like Cline) ..."
    },
    {
        "title": "Announcing Spring AI MCP: A Java SDK for the Model Context ...",
        "link": "https://spring.io/blog/2024/12/11/spring-ai-mcp-announcement",
        "snippet": "Dec 11, 2024 ... This SDK will enable Java developers to easily connect with an expanding array of AI models and tools while maintaining consistent, reliable integration ..."
    },
    {
        "title": "Implementing a MCP server in Quarkus - Quarkus",
        "link": "https://quarkus.io/blog/mcp-server/",
        "snippet": "6 days ago ... The Model Context Protocol (MCP) is an emerging standard that enables AI models to safely interact with external tools and resources. In this tutorial, I'll ..."
    },
    {
        "title": "mark3labs/mcp-go: A Go implementation of the Model ... - GitHub",
        "link": "https://github.com/mark3labs/mcp-go",
        "snippet": "Dec 18, 2024 ... A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools."
    },
    {
        "title": "MCP enables Claude to Build, Run and Test Web Apps by Looking ...",
        "link": "https://wonderwhy-er.medium.com/mcp-enable-claude-to-build-run-and-test-web-apps-using-screenshots-3ae06aea6c4a",
        "snippet": "Dec 18, 2024 ... How to Replicate My Experiment on Your Machine. If you're ready to dive into setting up MCP for Claude, follow these steps: ... 2. Download the Project: ... 3."
    },
    {
        "title": "MCP definition and meaning | Collins English Dictionary",
        "link": "https://www.collinsdictionary.com/dictionary/english/mcp",
        "snippet": "2 days ago ... 2 meanings: male chauvinist pig → informal, derogatory a man who exhibits male chauvinism Abbreviation: MCP.... Click for more definitions."
    },
    {
        "title": "What is Anthropic's New MCP Standard and How Can It Improve ...",
        "link": "https://dappier.medium.com/what-is-anthropics-new-mcp-standard-and-how-can-it-improve-your-ai-agent-be6f6c72eb6a",
        "snippet": "Nov 26, 2024 ... Anthropic has released a new protocol, MCP, for connecting AI agents to data sets. This blog explores when and why developers might use MCP to improve their ..."
    },
    {
        "title": "Mostafa Gharib on LinkedIn: What is MCP and how it works",
        "link": "https://www.linkedin.com/posts/mostafa-gharib_what-is-mcp-and-how-it-works-activity-7274301560594026497-p_yq",
        "snippet": "Dec 15, 2024 ... ... MCP Host can use. (Bonus: SDKs in Python and TypeScript make it easy to build these servers!) 2️⃣ MCP Clients These interact with MCP Servers via the protocol."
    }
]

Google Custom Search Engine MCP Server

Integrations