使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个基于 MCP 的服务器，运行于 Cloudflare Workers 上，提供 30 个工具集合（日期/时间、数学、文本处理、验证、KV 存储、Workers AI），并通过 OAuth 2.0 进行身份认证，允许 LLM 客户端通过 MCP 协议调用工具、读取资源、执行外部功能和渲染提示模板。

• 主要功能点

  • MCP 协议核心能力：支持初始化、列出工具、调用工具等标准 MCP 请求/响应流程。
  • 30 种工具分布在 6 类别，涵盖时间、计算、文本、校验、KV、AI/嵌入等功能。
  • 边缘部署：基于 Cloudflare Workers，实现全球低延迟的边缘执行。
  • 安全性：Bearer Token 认证、输入校验、HTML/文本安全处理、速率限制（后续可扩展）。
  • 集成能力：内置 Workers AI、KV 存储、外部 API 调用等能力，便于形成可扩展的上下文服务。

• 安装步骤

  • 符合要求的运行环境：Node.js 18+、Cloudflare 账户、Wrangler CLI。
  • 安装依赖并构建/部署到 Cloudflare Workers。
  • 配置 KV 命名空间与认证令牌（在 wrangler 配置中设置 KV 命名空间、AUTH_TOKEN 等变量），并将应用部署到你自己的 Worker（生产环境会使用你自有的域名与 Worker URL）。
  • 参考部署示例获取 MCP 服务端地址，例如 https://your-worker.workers.dev/mcp。

• 服务器配置 MCP 客户端在连接服务器时需要提供以下信息以启动远端 MCP 服务（仅用于客户端配置，服务器端信息来自仓库实现）：

  • server 名称（name）：cloudflare-toolbox
  • 命令（command）：npx
  • 参数（args）：-y mcp-remote https://your-worker.workers.dev/mcp
  • 环境变量（env）可选，用于传递认证头，例如： MCP_REMOTE_HEADERS: "{"Authorization":"Bearer YOUR_TOKEN"}" 注：以上为示意配置，用以在 MCP 客户端启动远程工具服务器时提供必要信息。实际连接地址请使用你部署后的 Worker 地址和授权令牌。

• 基本使用方法

  • 启动与连接：将 MCP 客户端配置为连接到你部署的 MCP 服务器地址（/mcp 路径），并在请求头中包含 Bearer Token 进行鉴权。
  • 交互流程示例（简述）：
    1. 发送 initialize 请求，声明协议版本。
    2. 发送 tools/list 请求，获取可用工具列表。
    3. 调用某个工具（如 get_current_datetime），附带所需参数。
    4. 服务器返回工具执行结果的 JSON-RPC 响应。
  • 具体工具的使用将通过 MCP 客户端/LLM 的对话流程来完成，可以在你的提示模板中参考仓库提供的示例请求格式。