JinDaGe - workers-mcp-demo MCP Details

article

README

🚀 云flare 工作者 MCP 演示

本项目是一个简单的演示，借助 Cloudflare Workers MCP 创建自定义 AI 工具。这些工具可与 Claude、Cursor 及其他支持 MCP 的 AI 助手协同使用，为 AI 应用增添更多可能。

🚀 快速开始

本项目利用 Cloudflare Workers MCP 创建可被 AI 助手访问和使用的自定义工具，以此扩展 AI 的能力。下面为你详细介绍操作步骤：

前提条件

Node.js (v16 或更高版本)
pnpm 包管理器
Cloudflare 账户
Wrangler CLI
Claude Desktop、Cursor 或其他支持 MCP 的客户端

设置步骤

1. 克隆此仓库

git clone https://github.com/akazwz/workers-mcp-demo.git
cd workers-mcp-demo

2. 安装依赖

pnpm install

3. 配置你的 Cloudflare Worker

确保你已经通过 Wrangler 登录到 Cloudflare：

pnpx wrangler login

然后运行 MCP 设置命令：

npx workers-mcp setup

这将自动配置你的 Worker 以支持 MCP。

⚠️ 重要提示

如果你是 Cloudflare Workers 的免费用户（非付费用户），需要修改 wrangler.jsonc 文件，删除或注释掉以下配置：

"browser": {
  "binding": "BROWSER"
}

这是因为 Browser Rendering API 仅适用于付费用户。删除此配置后，screenshotURL 和 extractImagesFromURL 功能将无法使用，但其他功能仍然可以正常工作。

4. 部署你的 Worker

pnpm run deploy

5. 配置你的 MCP 客户端

对于 Claude Desktop：

运行以下命令在 Claude 中安装你的 MCP 服务器：

pnpx workers-mcp install:claude

对于 Cursor：

在 Cursor 的 MCP 配置中添加以下内容：

{
  "type": "command",
  "command": "/path/to/workers-mcp run workers-mcp-demo https://your-worker-url.workers.dev /path/to/workers-mcp-demo"
}

✨ 主要特性

自定义 AI 工具：可在 Cloudflare Workers 上运行。
无缝集成：能与 Claude、Cursor 和其他 MCP 客户端实现无缝集成。
能力扩展：能够通过自己的无服务器函数扩展 AI 能力。

📦 安装指南

克隆仓库

git clone https://github.com/akazwz/workers-mcp-demo.git
cd workers-mcp-demo

安装依赖

pnpm install

配置 Cloudflare Worker

pnpx wrangler login
npx workers-mcp setup

部署 Worker

pnpm run deploy

💻 使用示例

基础用法

配置完成后，你可以直接从 AI 助手使用你的自定义 MCP 工具。例如，在 Claude Desktop 中，你可以使用如下命令：

@workers-mcp-demo getRandomNumber

📚 详细文档

什么是 MCP？

MCP (Model Context Protocol) 是由 Anthropic 开源的一个标准，用于连接 AI 助手与数据源，包括内容仓库、业务工具和开发环境。它的目标是帮助前沿模型生成更好、更相关的回应。

可用工具

此演示包括以下工具：

getRandomNumber：生成一个随机数
generateImage：根据文本提示创建图像
screenshotURL：对指定 URL 进行截图（需要付费账户）
extractImagesFromURL：从网页中提取图像（需要付费账户）

自定义

要添加自己的工具，编辑 src/index.ts 文件并向 Worker 类添加新方法。更改后，使用以下命令重新部署你的 Worker：

pnpm run deploy

故障排除

如果你的 AI 助手看不到你的工具，尝试重启助手。
如果你更改了方法名称或参数，你需要重启 AI 助手才能使更改生效。
检查 Cloudflare Workers 日志以查看部署中的任何错误。
如果使用免费账户时出现 Error: Browser Rendering API is only available for Workers Paid plans 错误，请参考上面的免费用户配置注意事项。

📄 许可证

本项目采用 MIT 许可证。

致谢

Cloudflare Workers MCP 提供底层框架
Anthropic Model Context Protocol 开源的 MCP 标准
Cloudflare Workers 提供无服务器平台

workers-mcp-demo