MCP Demo

MCP Demo

site icon
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 错误。

使用教程

使用依赖

安装教程

  1. 克隆此仓库
git clone https://github.com/akazwz/workers-mcp-demo.git
cd workers-mcp-demo
  1. 安装依赖
pnpm install
  1. 配置你的 Cloudflare Worker
pnpx wrangler login
npx workers-mcp setup
  1. 部署你的 Worker
pnpm run deploy
  1. 配置你的 MCP 客户端
  2. 对于 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 日志以查看部署中的任何错误。

许可证

该项目遵循 MIT 开源许可条款。