本项目将带领大家搭建一个基于 Cloudflare Workers 的远程 MCP 服务器,并且集成 OAuth 登录功能,为你提供便捷的服务体验!
在本地开发环境中搭建项目,可按以下步骤操作:
# 克隆仓库
git clone git@github.com:cloudflare/ai.git
# 安装依赖项
cd ai
npm install
# 本地运行
npx nx dev remote-mcp-server
完成上述步骤后,你可以打开浏览器窗口,访问 http://localhost:8787/ 进行测试。
若要探索新的 MCP API,你可以借助 MCP 检查员,具体操作如下:
npx @modelcontextprotocol/inspector 启动检查员。http://localhost:5173),切换传输类型为 SSE,并输入 http://localhost:8787/sse 作为 MCP 服务器的 URL,然后点击 "连接"。MCP 检查员功能强大,但我们更希望将其与 Claude 连接起来。你可以按照 Anthropic 的快速入门指南,并在 Claude Desktop 中转到设置 > 开发者 > 编辑配置文件以找到你的配置文件。
在文本编辑器中打开该文件,并用以下配置替换其内容:
{
"mcpServers": {
"math": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8787/sse"
]
}
}
}
这将运行一个本地代理,使 Claude 能够通过 HTTP 与你的 MCP 服务器通信。
当你打开 Claude 时,浏览器窗口应打开并允许你登录。你会在右下角看到可用工具的列表,根据提示,Claude 应该会调用 MCP 加法工具来回答问题。
若要将项目部署到 Cloudflare,可按以下步骤操作:
npx wrangler kv namespace create OAUTH_KVwrangler-config.ts 文件中npm run build 和 npm run deploy 部署代码到 Cloudflare Workers在 Claude 的配置文件中,更新如下:
{
"mcpServers": {
"math": {
"command": "npx",
"args": [
"mcp-remote",
"https://your-deployed-url.com/sse"
]
}
}
}
请将 your-deployed-url.com 替换为你实际部署的 URL。
若要测试连接,可以运行以下命令:
npx mcp-remote https://your-deployed-url.com/sse
如果出现问题,请确保你的 Cloudflare Workers 服务已正确配置,并且你可以清除浏览器缓存以解决问题。