FindMCP Logo FindMCP.info
Workers MCP Server

Workers MCP Server

site icon
2025.01.09 0
TypeScriptCloudflare Workers 集成MCP 协议实现RPC 服务开发效率
Workers MCP Server 是一个基于 Cloudflare Workers 的 Model Context Protocol (MCP) 服务器实现，允许用户通过 Claude Desktop 等 MCP 客户端调用 Cloudflare Workers 的功能。它通过 RPC 语法提供对 Cloudflare 或第三方绑定的访问，支持自定义功能的扩展和调用。
View on GitHub

Overview

基本能力

产品定位

Workers MCP Server 是一个桥接工具，使得 Claude Desktop 等 MCP 客户端能够无缝调用 Cloudflare Workers 的功能，扩展客户端的操作能力。

核心功能

  • 通过 MCP 协议与 Claude Desktop 交互
  • 支持自定义 Worker 功能的远程调用
  • 自动生成 LLM 友好的 API 文档
  • 提供本地代理服务以简化远程调用

适用场景

  • 扩展 Claude Desktop 的功能
  • 快速开发和测试 Cloudflare Workers 功能
  • 构建基于 Worker 的自动化工具

工具列表

  1. Docs 生成工具：自动从 TypeScript 代码生成 API 文档
  2. 本地 MCP 代理：桥接本地 MCP 客户端和远程 Worker
  3. 部署工具：简化 Worker 的部署和配置过程

常见问题解答

  1. 文档生成限制：目前仅支持从 src/index.ts 生成文档，不支持导入的文件
  2. 错误处理：尚未完全实现完善的错误处理机制
  3. 开发模式支持：暂不支持 wrangler dev，但计划未来添加

使用教程

使用依赖

  1. 安装 Node.js 和 pnpm
  2. 安装 Cloudflare Wrangler CLI

安装教程

# 克隆仓库
git clone https://github.com/geelen/workers-mcp-server.git
cd workers-mcp-server

# 安装依赖
pnpm install

# 检查 wrangler.json 配置
# 根据需要注释掉不使用的 API 部分

# 部署 Worker
pnpm deploy:worker

# 生成并上传密钥
npx workers-mcp secret generate && npx workers-mcp secret upload

# 安装 MCP 服务器
npx workers-mcp install <server-alias> <worker-url>

# 重启 Claude Desktop

调试方式

  1. 修改 src/index.ts 文件
  2. 重新部署 Worker
pnpm deploy:worker
  1. 通常需要重启 Claude Desktop 以加载变更

工作原理

  1. 文档生成：使用 ts-blank-space 和 jsdoc-api 从代码生成 API 文档
  2. HTTP 处理器：提供 /rpc 端点处理远程调用
  3. 本地代理：使用 @modelcontextprotocol/sdk 构建本地 MCP 服务器

许可证

None