关键词

Cloudflare WorkersAI工具数据库访问LLM工具远程服务器

本项目是一个基于 Cloudflare Workers 构建的远程 MCP (Model Context Protocol) 服务器实现。它演示了如何在 Cloudflare 的无服务器环境中托管一个 MCP 服务器，并集成 Cloudflare D1 数据库和 Cloudflare Workers AI 模型，以提供更丰富的功能。

主要功能点：

  • 算术工具 (add, calculate)：提供基础的加法和更全面的四则运算能力。
  • 图书搜索工具 (searchBooks)：允许 LLM 通过结构化查询参数搜索 Cloudflare D1 数据库中的图书信息。支持按标题、作者、书架搜索，按评分排序和筛选，并限制结果数量。
  • AI 增强响应：图书搜索工具在获取数据库结果后，会将结果作为上下文发送给 Cloudflare Workers AI 的大模型（llama-3.3-70b-instruct-fp8-fast）进行处理和格式化，生成更自然、更易读的回复。
  • 多协议支持：服务器支持通过 SSE (Server-Sent Events) 和标准 HTTP (JSON-RPC) 协议与 MCP 客户端通信。
  • 无认证：此示例简化了部署，未包含认证层（适用于测试和开发环境）。

安装步骤：

本项目专为部署在 Cloudflare Workers 设计。最简单的部署方法是通过 Cloudflare 提供的 "Deploy to Workers" 按钮或使用 Cloudflare Wrangler CLI。

  1. 使用部署按钮 (推荐)： 点击 README 中的 "Deploy to Workers" 按钮（通常是一个链接）。这将引导您完成 Cloudflare Workers 的部署流程。
  2. 使用 Wrangler CLI： 确保您已安装 Node.js 和 npm，并已安装 Cloudflare Wrangler CLI。然后运行以下命令： 
    npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless
cd my-mcp-server
wrangler deploy
    根据提示完成部署。

无论哪种方式，部署完成后您将获得一个 Workers URL，例如 'remote-mcp-server-authless.<your-account>.workers.dev'。请注意，您可能需要配置 Cloudflare D1 数据库绑定（名为 'DB'）和 Cloudflare Workers AI 绑定（名为 'AI'），并确保数据库中有名为 'btable' 的图书数据表，供 'searchBooks' 工具使用。

服务器配置 (用于 MCP 客户端连接)：

MCP 客户端（如 Cloudflare AI Playground, Anthropic Claude Desktop 等）需要知道服务器的地址和连接方式才能使用其提供的工具。对于此服务器，您需要将客户端配置指向您部署后获得的 Workers URL。

例如，对于支持配置远程 MCP 服务器 URL 的客户端，您可以直接使用完整的服务器端点 URL。如果客户端需要配置命令和参数来启动一个代理进程 (如 mcp-remote)，则需要配置启动该代理的命令及其指向 Workers URL 的参数。

客户端配置示例（概念说明，具体格式取决于您的 MCP 客户端）：

  • 服务器名称: 一个描述性的名称，例如 "Cloudflare Book & Math Tools"

  • 连接方式: 通常是指定一个命令行程序 ('command') 及其参数 ('args') 来启动与远程服务器通信的代理。'args' 中会包含您的 Workers URL。

    • 'command': 例如 'npx' (用于运行 npm 包的可执行文件) 或 'mcp-remote' (一个 MCP 远程代理工具)。
    • 'args': 包含代理所需的参数，其中必须包含您的 Workers URL，例如 '["mcp-remote", "https://remote-mcp-server-authless.<your-account>.workers.dev/sse"]' （使用 SSE 协议）或 '["mcp-remote", "https://remote-mcp-server-authless.<your-account>.workers.dev/mcp"]' （使用 HTTP 协议）。

连接后，您的 MCP 客户端将能够发现并调用服务器提供的 'add', 'calculate', 和 'searchBooks' 工具。

基本使用方法：

  1. 部署服务器并获取 URL。
  2. 在您的 MCP 客户端中，按照客户端的文档配置连接到您部署的服务器 URL。
  3. 连接成功后，客户端通常会显示服务器提供的工具列表。
  4. 您现在可以直接在客户端界面或通过对话与这些工具交互，例如请求进行计算或搜索图书。

信息

分类

AI与计算

访问项目