Information
Google 自定义搜索引擎 MCP 服务器
这是一个使用 CSE(自定义搜索引擎)提供搜索功能的模型上下文协议服务器。该服务器使大型语言模型能够提供常规的谷歌搜索词,并返回找到的搜索结果。
该工具仅返回结果本身,而不返回内容,应与其他服务器如 mcp-server-fetch 结合使用以从搜索结果中提取内容。
您还可以将其与其他工具结合使用,以实现某种“深度搜索”或一般工具链。
免费配额为每天100次搜索(1次工具调用 == 1次搜索),如果您不想设置计费并且这对您的使用案例来说不足,您应该考虑使用其他服务器。
可用工具
google_search - 使用搜索词在自定义搜索引擎中进行搜索,并返回包含每个结果的标题、链接和摘要的结果列表。
search_term (字符串, 必需): 要搜索的搜索词,等同于常规 Google 搜索中的 查询参数 q。
环境变量
API_KEY (必需): 自定义搜索引擎的 API 密钥。
ENGINE_ID (必需): 自定义搜索引擎的引擎 ID。
SERVICE_NAME (必需/可选): 服务名称,如果未更改名称(customsearch)则留空。
COUNTRY_REGION (可选): 将搜索结果限制为来自特定国家/地区的文档。请参阅 国家参数值 获取有效值。
GEOLOCATION (可选,默认 "us"): 执行搜索的最终用户的地理位置。请参阅 地理位置参数值 获取有效值。
RESULT_LANGUAGE (可选,默认 "lang_en"): 搜索结果的语言。请参阅 CSE 查询参数, lr 获取有效值。
RESULT_NUM (可选,默认 10): 返回的搜索结果数量。范围从 1 到 10。
CSE 设置
创建自定义搜索引擎相对容易,完全免费,并且可以在5分钟内完成。
前往 https://console.cloud.google.com/ 并创建一个新项目。例如,可以命名为 "Claude CSE"。
选择该项目并在搜索栏中搜索 "Custom Search 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("What is MCP after:2024-11-01")
结果:
[
\{
"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."
\}
]