MCP 示例

这是一个使用 Cloudflare Workers MCP 创建的简单演示项目，用于自定义AI工具，这些工具可以与Claude、cursor和其他支持MCP的AI助手一起使用。

什么是MCP？

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

该项目利用Cloudflare Workers MCP创建可被AI助手访问和使用的自定义工具，从而扩展AI的能力。

特性

• 在Cloudflare Workers上运行的自定义AI工具
• 无缝集成到Claude、cursor和其他MCP客户端
• 通过自身的无服务器函数扩展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助手使用自定义的MCP工具。例如，在Claude Desktop中，你可以使用以下命令：

@workers-mcp-demo getRandomNumber

可用工具

此演示包括以下工具：

• 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 License。

致谢

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