跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

将 AI Search 连接到 MCP 客户端

最后更新 查看 MarkdownAgent 设置

每个 AI Search 实例都可以公开内置的 Model Context Protocol (MCP) ↗ 端点。该端点在您已建立索引的内容上提供 search 工具,因此任何 MCP 客户端或代理(例如 AI 助手或 IDE)都可以在无需编写代码的情况下搜索您的知识库。

本指南将创建一个对文档站点建立索引的 AI Search 实例,然后将其公开为任何 MCP 客户端都可以调用的搜索工具。

前提条件

  1. 注册 Cloudflare 账户 ↗。
  2. 安装 Node.js ↗。

Node.js 版本管理器

使用 Vite+ (vp env) ↗ 安装和管理 Node.js 版本。

有关支持的 Node.js 版本,请参阅 Wrangler 系统要求。

要对网站建立索引,您还需要一个已加入 Cloudflare 账户的域名。否则,您可以将自己的文件上传到内置存储。

1. 创建 AI Search 实例

如果您已有包含已索引内容的实例,请跳至第 2 步。

使用 Wrangler CLI 创建实例。本示例对文档站点建立索引,使用位于 developers.cloudflare.com 的 Cloudflare 开发者文档,以便助手可以据此回答问题。将站点连接为网站数据源,以便 AI Search 自动爬取并建立索引:

npx wrangler ai-search create docs-search --type web-crawler --source developers.cloudflare.com

将 developers.cloudflare.com 替换为您已加入 Cloudflare 账户的域名,因为您只能爬取您拥有的站点。若要在不爬取站点的情况下建立内容索引,请运行 npx wrangler ai-search create docs-search --type builtin,并将文件上传到内置存储。

检查索引进度:

npx wrangler ai-search stats docs-search

索引完成后,您的实例将具有可通过 MCP 公开的内容。

2. 启用 MCP 端点

实例的公共端点会提供 MCP 端点。

  1. 在 Cloudflare 仪表板中前往 AI Search。

    前往 AI Search ↗
  2. 选择您的 docs-search 实例。

  3. 前往 Settings(设置) > Public Endpoint(公共端点)。

  4. 打开 Enable Public Endpoint(启用公共端点),然后打开 MCP 端点。

  5. 复制端点主机。您的 MCP URL 是该主机加上 /mcp:

    https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/mcp

3. 描述您的搜索工具

MCP 客户端会读取工具描述以决定何时调用它。在 Settings(设置) > Public Endpoint(公共端点) 下,将 Tool Description(工具描述) 设置为说明您的内容覆盖范围及其可回答的问题。例如:

Search the Cloudflare Developer Documentation for product concepts,
configuration, and API references. Use this when users ask how to build
or configure Cloudflare products.

具体的描述有助于代理在正确的时机调用您的搜索工具。完整配置请参阅 Public endpoint 设置。

4. 连接 MCP 客户端

将 MCP URL 作为远程 MCP 服务器添加到客户端。许多客户端使用如下所示的 mcpServers 配置:

{
	"mcpServers": {
		"ai-search": {
			"url": "https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/mcp"
		}
	}
}

确切配置取决于您的客户端。某些客户端要求服务器条目上有传输字段,例如远程 HTTP 服务器的 "type": "http",因此请参阅 MCP 客户端文档了解如何添加远程服务器。连接后,客户端可以调用 search 工具,从您的实例检索相关内容。

要直接测试端点或构建自己的客户端,请参阅 MCP 了解请求格式。

安全注意事项

公共端点不要求身份验证,因此任何拥有其 URL 的人都可以查询已索引内容。

要要求身份验证,请添加自定义域名,并通过 Cloudflare Access 保护它。随后,MCP 客户端会使用请求头中发送的 Access 服务令牌进行身份验证。

如果保持端点公开:

  • 仅对可安全公开的内容建立索引。
  • 在 Settings(设置) > Public Endpoint(公共端点) 下启用速率限制。
  • 在 Authorized hosts 下限制允许的来源。此设置只影响浏览器客户端。

详情请参阅 Public endpoint 设置。

后续步骤

这篇文档对您有帮助吗?