模型上下文协议 (MCP) 服务器

这是一个 MCP 服务器，它将要求用户首先进行身份验证。 然后，MCP 服务器将能够代表用户调用受保护的 API。

配置

Todos API

在使用 MCP 服务器之前，您需要按照此处的文档部署 Todos API。

Auth0 配置

在 Auth0 仪表板中，在“应用程序”部分创建一个新应用程序（类型：“常规 Web 应用程序”）。

<img src="../docs/create-application.jpg" width="500" alt="创建应用程序">

创建应用程序后，在本地开发时，将以下 URL 配置为回调 URL：

http://localhost:8788/callback

设置 KV 命名空间

• 创建 KV 命名空间： wrangler kv:namespace create "OAUTH_KV"
• 使用 KV ID 更新 Wrangler 文件

环境变量

此 MCP 服务器需要配置一些环境变量：

设置	描述
AUTH0_DOMAIN	您的 Auth0 租户的域名（例如，acme.auth0.com）
AUTH0_CLIENT_ID	您在 Auth0 应用程序中创建的客户端 ID
AUTH0_CLIENT_SECRET	您在 Auth0 应用程序中创建的客户端密钥
AUTH0_AUDIENCE	您在 Auth0 仪表板中注册的 API 的唯一标识符（例如，urn:todos-api）
AUTH0_SCOPE	MCP 服务器请求的范围。 在这里，我们请求基本配置文件信息（openid email profile），刷新令牌功能（offline_access）和 API 访问权限（read:todos）
NODE_ENV	环境设置 - 本地开发使用 development
API_BASE_URL	您的 Todos API 正在运行的基本 URL

开发

在项目的根目录中创建一个 .dev.vars 文件，其结构如下：

AUTH0_DOMAIN=yourdomain.us.auth0.com
AUTH0_CLIENT_ID=您在 Auth0 中创建的应用程序的客户端 ID
AUTH0_CLIENT_SECRET=您在 Auth0 中创建的应用程序的客户端密钥
AUTH0_AUDIENCE=urn:todos-api
AUTH0_SCOPE=openid email profile offline_access read:todos
NODE_ENV=development
API_BASE_URL=http://localhost:8789

测试 MCP 服务器

要启动 MCP 服务器，可以使用以下命令：

npm run dev

使用 MCP Inspector，您可以连接到 MCP 服务器，列出可用的工具并调用它们。 确保将传输类型设置为 sse，并将 URL 设置为 http://localhost:8788/sse。

<img src="../docs/local.jpg" width="750" alt="MCP Inspector">

将 MCP 服务器部署到 Cloudflare

要将 MCP 服务器部署到 Cloudflare，您首先需要设置以下密钥：

wrangler secret put AUTH0_DOMAIN
wrangler secret put AUTH0_CLIENT_ID
wrangler secret put AUTH0_CLIENT_SECRET
wrangler secret put AUTH0_AUDIENCE
wrangler secret put AUTH0_SCOPE
wrangler secret put API_BASE_URL

设置密钥后，可以使用以下命令部署 API：

npm run deploy

在 Auth0 仪表板中，还请确保为已部署的 MCP 服务器添加新的回调 URL，例如：

https://mcp-auth0-oidc.<your-subdomain>.workers.dev/callback

要对此进行测试，您现在可以使用 Workers AI LLM Playground。 导航到 https://playground.ai.cloudflare.com/，并使用以下 URL 模式在左下方连接到您的 MCP 服务器：

https://mcp-auth0-oidc.<your-subdomain>.workers.dev/sse

这将打开一个弹出窗口，您可以在其中登录，之后您将能够使用所有工具。

<img src="../docs/playground.png" width="750" alt="Workers AI LLM Playground">

故障排除

如果在设置或使用 MCP 服务器时遇到任何问题，请按照以下故障排除步骤操作：

检查 Worker 日志

访问仪表板中的 Cloudflare Workers 日志

Auth0 仪表板日志

• 导航到 Auth0 仪表板中的“日志”部分
• 查看身份验证尝试和失败

<img src="../docs/troubleshooting.png" width="750" alt="Auth0 日志">

常见问题

• 如果身份验证失败，请验证您的 Auth0 配置和密钥
• 对于连接问题，请确保您的 Worker 已部署且域名正确
• 检查所有回调 URL 是否在 Auth0 中正确配置
• 验证 API_BASE_URL 是否与您部署的 API 端点匹配