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

MCP 工具

最后更新 查看 MarkdownAgent 设置

Agent 可作为 Model Context Protocol (MCP) 的客户端。将 Agent 连接到外部 MCP 服务器,发现这些服务器暴露的工具,并将这些工具传入模型调用。

在以下场景使用 MCP:

  • 调用外部 MCP 服务器暴露的工具。
  • 在 Agent、IDE 和其他 AI 客户端之间复用工具。
  • 连接到已暴露 MCP 端点的服务。
  • 为外部工具访问添加 OAuth 或基于 token 的授权。

若要构建 MCP 服务器,请参阅 Model Context Protocol (MCP)。

基本模式

调用 addMcpServer() 连接到远程 MCP 服务器,然后将 this.mcp.getAITools() 传给 AI SDK。

import { Agent } from "agents";
import { generateText } from "ai";
import { createAI } from "agents/models/ai-sdk";

export class ToolAgent extends Agent {
	async onStart() {
		await this.addMcpServer("github", "https://mcp.github.com/mcp");
	}

	async onRequest(request) {
		const ai = createAI({ binding: this.env.AI });

		const response = await generateText({
			model: ai("@cf/zai-org/glm-4.7-flash"),
			prompt: "Use available tools to summarize the latest issue activity.",
			tools: this.mcp.getAITools(),
		});

		return new Response(response.text);
	}
}
import { Agent } from "agents";
import { generateText } from "ai";
import { createAI } from "agents/models/ai-sdk";

export class ToolAgent extends Agent<Env> {
    async onStart() {
        await this.addMcpServer("github", "https://mcp.github.com/mcp");
    }

    async onRequest(request: Request) {
        const ai = createAI({ binding: this.env.AI });

        const response = await generateText({
            model: ai("@cf/zai-org/glm-4.7-flash"),
            prompt: "Use available tools to summarize the latest issue activity.",
            tools: this.mcp.getAITools(),
        });

        return new Response(response.text);
    }
}

若服务器需要 OAuth,addMcpServer() 会返回身份验证状态和授权 URL。连接会持久化到 Agent 的 SQL 存储 中。

配置

对于公开 MCP 服务器,无需 binding 配置。将服务器 URL、API token 或 OAuth 设置存储为环境变量或 secret。

对于需要 bearer token 或 Cloudflare Access 头的 MCP 服务器,连接时传入自定义传输头。

await this.addMcpServer("internal", this.env.MCP_SERVER_URL, {
	transport: {
		headers: {
			Authorization: `Bearer ${this.env.MCP_TOKEN}`,
			"CF-Access-Client-Id": this.env.CF_ACCESS_CLIENT_ID,
			"CF-Access-Client-Secret": this.env.CF_ACCESS_CLIENT_SECRET,
		},
	},
});
await this.addMcpServer("internal", this.env.MCP_SERVER_URL, {
    transport: {
        headers: {
            Authorization: `Bearer ${this.env.MCP_TOKEN}`,
            "CF-Access-Client-Id": this.env.CF_ACCESS_CLIENT_ID,
            "CF-Access-Client-Secret": this.env.CF_ACCESS_CLIENT_SECRET,
        },
    },
});

相关资源

McpClient API

将 Agent 连接到外部 MCP 服务器并使用其工具、资源和 prompt。

这篇文档对您有帮助吗?