
MCP Demo

2025.03.07
27
TypeScriptAI 工具扩展无服务器部署开发效率内容生成
workers-mcp-demo 是一个基于 Cloudflare Workers MCP 的演示项目,用于创建自定义 AI 工具,这些工具可以与 Claude、Cursor 和其他支持 MCP 的 AI 助手一起使用。该项目利用 Model Context Protocol (MCP) 标准,通过无服务器函数扩展 AI 的能力,提供了一系列自定义工具,如生成随机数、创建图像、网页截图等。
View on GitHub
Overview
基本能力
产品定位
workers-mcp-demo 是一个用于扩展 AI 助手能力的自定义工具集,通过 Cloudflare Workers 实现无服务器部署,与支持 MCP 的 AI 助手无缝集成。
核心功能
- 在 Cloudflare Workers 上运行的自定义 AI 工具
- 与 Claude、Cursor 和其他 MCP 客户端的无缝集成
- 能够通过自己的无服务器函数扩展 AI 能力
适用场景
- 开发者在 AI 助手中集成自定义功能
- 需要快速扩展 AI 助手能力的场景
- 无服务器环境下部署 AI 工具
工具列表
getRandomNumber
:生成一个随机数generateImage
:根据文本提示创建图像screenshotURL
:对指定 URL 进行截图(需要付费账户)extractImagesFromURL
:从网页中提取图像(需要付费账户)
常见问题解答
- 如果 AI 助手看不到工具,尝试重启助手。
- 更改方法名称或参数后,需要重启 AI 助手使更改生效。
- 检查 Cloudflare Workers 日志以查看部署中的任何错误。
- 免费用户需修改配置以避免 Browser Rendering API 错误。
使用教程
使用依赖
- Node.js (v16 或更高版本)
- pnpm 包管理器
- Cloudflare 账户
- Wrangler CLI
- Claude Desktop、Cursor 或其他支持 MCP 的客户端
安装教程
- 克隆此仓库
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
- 配置你的 MCP 客户端
- 对于 Claude Desktop:
pnpx workers-mcp install:claude
- 对于 Cursor:
{
"type": "command",
"command": "/path/to/workers-mcp run workers-mcp-demo https://your-worker-url.workers.dev /path/to/workers-mcp-demo"
}
调试方式
- 使用以下命令测试工具功能:
@workers-mcp-demo getRandomNumber
- 检查 Cloudflare Workers 日志以查看部署中的任何错误。