Skip to main content
Glama

MCP Demo

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

什么是 MCP?

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

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

Related MCP server: Remote MCP Server Authless

特点

  • 在 Cloudflare Workers 上运行的自定义 AI 工具

  • 与 Claude、Cursor 和其他 MCP 客户端的无缝集成

  • 能够通过自己的无服务器函数扩展 AI 能力

前提条件

设置步骤

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 许可证。

致谢

Available Tools

2 tools
get_current_dateB

获取当前日期, 如果用户没有提供日期, 则返回当前日期, 如果用户提供的是相对单位, 如前天, 昨天, 明天, 则返回相对单位后的日期

Inputs: date (required).

get_current_weatherC

Get weather info for a given city.

Inputs: city (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: get_current_date handles date retrieval and relative date calculations, while get_current_weather provides weather information for cities. There is no overlap in functionality, making it impossible to confuse them.

    Naming Consistency5/5

    Both tools follow a consistent 'get_current_' prefix pattern with a descriptive noun suffix (date, weather). This clear and uniform naming convention makes the tools easily identifiable and predictable.

    Tool Count2/5

    With only two tools, the server feels extremely thin and under-scoped for a general-purpose demo. While each tool is functional, the set lacks breadth, suggesting it might be incomplete or overly narrow for practical agent use.

    Completeness2/5

    Given the server's name 'Workers MCP Demo', which implies a broader utility or demo purpose, the toolset is severely incomplete. It covers only date and weather queries, missing many common demo functionalities like data processing, API testing, or other utility operations.

    Related MCP Connectors

    Related MCP Servers