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

测试远程 MCP 服务器

最后更新 查看 MarkdownAgent 设置

Remote、authorized 连接是 Model Context Protocol (MCP) 规范 ↗中仍在演进的部分。并非所有 MCP 客户端都已支持 remote 连接。

本指南介绍如何在支持 remote 连接的 MCP 客户端上开始使用 remote MCP server。若你尚未创建并部署 remote MCP server,请先遵循构建 Remote MCP Server 指南。

模型上下文协议 (MCP) inspector

@modelcontextprotocol/inspector 包 ↗是 MCP server 的可视化测试工具。

  1. 打开终端并运行以下命令:

    npx @modelcontextprotocol/inspector
    🚀 MCP Inspector is up and running at:
        http://localhost:5173/?MCP_PROXY_AUTH_TOKEN=46ab..cd3
    
    🌐 Opening browser...

    MCP Inspector 会在 Web 浏览器中启动。你也可以手动打开浏览器并访问 http://localhost:<PORT>。查看命令输出以确认 MCP Inspector 的本地端口。本例中 MCP Inspector 在端口 5173 上提供服务。

  2. 在 MCP inspector 中输入 MCP server 的 URL(例如 http://localhost:8788/mcp)。选择 Connect(连接)。

    你可以连接运行在本地机器上的 MCP server,或运行在 Cloudflare 上的 remote MCP server。

  3. 若 server 需要身份验证,连接会失败。要进行身份验证:

    1. 在 MCP Inspector 中选择 Open Auth settings(打开身份验证设置)。
    2. 选择 Quick OAuth Flow(快速 OAuth 流程)。
    3. 通过 OAuth provider 完成身份验证后,会重定向回 MCP Inspector。选择 Connect(连接)。

你应看到 List tools(列出工具) 按钮,它会列出 MCP server 暴露的工具。

将远程 MCP 服务器连接到 Cloudflare Workers AI Playground

访问 Workers AI Playground ↗,输入 MCP server URL,并点击 "Connect"。完成身份验证(如需要)后,你应看到列出的工具,并可在聊天中供 AI 模型使用。

将远程 MCP 服务器连接到 Claude Code

使用 Streamable HTTP 将远程服务器直接添加到 Claude Code:

claude mcp add --transport http my-server https://my-mcp-server.my-account.workers.dev/mcp

运行 claude mcp list 验证连接。如果服务器需要身份验证,请在浏览器中完成授权流程。

将 remote MCP server 连接到 Cursor

通过编辑项目的 .cursor/mcp.json 或全局 ~/.cursor/mcp.json,并添加以下配置,将 Cursor ↗ 连接到 remote MCP server:

{
    "mcpServers": {
        "my-server": {
            "url": "http://my-mcp-server.my-account.workers.dev/mcp"
        }
    }
}

将 remote MCP server 连接到 Windsurf

通过编辑 mcp_config.json 文件 ↗并添加以下配置,将 remote MCP server 连接到 Windsurf ↗:

{
    "mcpServers": {
        "my-server": {
            "serverUrl": "http://my-mcp-server.my-account.workers.dev/mcp"
        }
    }
}

这篇文档对您有帮助吗?