在 Cloudflare Workers 上使用 Bearer 认证的 MCP 服务器

此仓库展示了一个概念验证实现，即在 Cloudflare Workers 上运行带有简单 bearer token 认证的 Model Context Protocol (MCP) 服务器。

概览

该项目展示了如何：

• 在 Cloudflare 的边缘网络上部署 MCP 服务器
• 实现基本的 bearer token 认证
• 通过无服务器架构创建和暴露 MCP 工具

本地开发

# Install dependencies
npm install

# Run the server locally
npm run dev

启动服务器后，它将可以在 http://localhost:8787 访问。

认证

此实现使用简单的 bearer token 认证方案。客户端必须在其请求中提供一个 Authorization 头。服务器会将此 token 传递给 MCP 工具，允许工具根据认证用户执行操作。

使用 MCP Inspector 测试

您可以使用 MCP Inspector 来测试您的 MCP 服务器：

1. 安装并启动检查器：

   npx @modelcontextprotocol/inspector
   

2. 配置检查器：

   • 将传输类型切换为 SSE
   • 输入您的 MCP 服务器的 URL（本地：http://localhost:8787/sse 或已部署：https://your-worker.workers.dev/sse）
   • 在授权字段中添加一个 bearer token
   • 点击“连接”

3. 测试功能：

   • 点击“列出工具”查看可用工具
   • 尝试运行“getToken”工具，该工具将返回您的授权头
   • 尝试使用两个数字测试“add”工具以测试基本功能

部署到 Cloudflare

将您的 MCP 服务器部署到 Cloudflare Workers：

npm run deploy

部署后，您的服务器将在 https://your-worker.workers.dev 可用。

项目结构

• src/index.ts - 包含 MCP 工具定义的主要服务器实现
• src/utils.ts - 用于渲染网页界面的帮助工具
• wrangler.jsonc - Cloudflare Workers 配置文件

重要提示

这是一个旨在演示 MCP 如何在无服务器环境中运行的概念验证实现。在生产环境中，您可能希望实现：

• 更健壮的认证（如 OAuth、token 验证等）
• 速率限制及其他安全措施
• 正确的错误处理与监控

故障排查

如果您遇到问题：

1. 确保您的 bearer token 在 Authorization 头中格式正确
2. 检查 Cloudflare 控制台中的 worker 日志
3. 尝试重启本地开发服务器

对于持续存在的认证问题，您可能需要清除任何缓存的凭据：

rm -rf ~/.mcp-auth