n8n MCP SaaS 服务器

关键词

多租户边缘计算自动化集成云端 API 管理安全认证

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现一个符合 MCP（Model Context Protocol）的后端服务器，用于向 MCP 客户端（如 Claude Desktop、Cursor 等）提供上下文信息、执行工具、管理资源，以及渲染与提供提示模板等功能。服务以 JSON-RPC 的方式对外交互，支持多租户、授权、速率限制、以及 SaaS 化部署等特性，核心运行在 Cloudflare Workers 上，并提供本地/直接模式与 SaaS 模式两种调用路径。

  • 主要功能点

    • MCP 核心能力实现
      • 支持 MCP 的初始化、工具列表查询与工具调用，响应以 MCP 兼容的 JSON-RPC 结构返回。
      • 提供 32 个 MCP 工具，覆盖工作流、执行、凭据、标签、变量、用户等常用操作，映射到 n8n API 或通过 SaaS 平台代理执行。
    • 资源与工具管理
      • 资源/连接/凭据等对象的管理接口，支持多租户和权限控制。
      • 提供对外部服务（如 n8n 实例、云端 API、OIDC/OAuth、邮件通知、支付等）的接入与管理。
    • 安全与合规
      • API Key 与 JWT 身份校验、速率限制、每日/月度用量统计。
      • 支付/订阅相关的端点（如 Stripe 集成）、邮件通知等。
    • SaaS 与边缘部署
      • 以 Cloudflare Workers 实现边缘部署，提供 SaaS 账单、用户、连接管理等能力，以及对接外部 n8n 实例的代理调用。
    • 开发与测试工具
      • 提供本地/直接模式测试脚本、标准化 MCP 测试用例、以及对接真实 n8n 实例的测试方案。

  • 安装步骤

    • 需求准备
      • Node.js 18 及以上版本
      • Cloudflare 帐号、Wranger 工具
    • 获取代码
      • 克隆仓库并进入项目目录
    • 配置与部署
      • 根据 README 提示完成 Cloudflare D1 数据库、KV、密钥等资源的创建与配置（如 JWT_SECRET、ENCRYPTION_KEY、OAuth、APP_URL、RESEND 等密钥）。
      • 使用 Wranger 登录并按文档配置 wrangler.toml、D1 数据库、KV 命名空间，以及所需的秘密信息。
      • 部署 API 服务至 Cloudflare Workers，前端 Dashboard 可选单独部署。
    • 本地/直接模式测试
      • 提供的 test-server 与 test-script 可用于在本地模拟 MCP 客户端与对接 n8n 实例的调用，便于快速验证 MCP 工具和代理逻辑。

  • 服务器配置（MCP 客户端需要的配置信息说明，非代码展示）

    • serverName（服务器名称）: n8n-mcp-server
    • command（启动命令）: node
    • args（启动参数）: 该 MCP 服务器在本仓库中有两种运行模式：
      • SaaS 模式时，需提供 SaaS 平台的 API 密钥，示例参数注释为：向 stdio-server.js 传入你的 SaaS API 密钥作为参数。
      • 直接模式时，需提供目标 n8n 实例的 URL 与 API Key，以直接对接本地或远程 n8n。
    • 注释说明（简要解读，便于理解配置用途）
      • 服务器名称用于区分不同的 MCP 服务实例。
      • 启动命令与参数决定 MCP 客户端连接的目标路径，是走 SaaS 的代理路径还是直接对接某个 n8n 实例。
      • 具体参数请以仓库提供的示例与注释为准，确保在真实环境中传递正确的密钥与地址信息。

  • 基本使用方法

    • 启动与连接
      • 启动 MCP 服务器（SaaS 模式或直接模式），确保云资源、密钥和数据库均配置完毕。
      • MCP 客户端（Claude Desktop、Cursor 等）在配置中指向服务器端的 mcp 端点，通过配置的 Authorization Bearer 令牌进行访问。
    • 常见操作
      • 请求工具列表：客户端发送初始化/工具列表请求，服务器返回可用的 32 个工具及其描述。
      • 调用工具：客户端通过工具调用接口执行具体工具，服务器将请求转发到直连的 n8n 实例或通过 SaaS 平台代理执行，并返回结果。
    • 安全与授权
      • 使用 JWT/API Key 进行认证，服务器实现令牌校验、访问控制及速率限制，确保多租户环境的隔离性与安全性。
    • 监控与运维
      • 通过 API 查看使用统计、订阅计划、连接状态等信息；必要时可结合云端仪表板进行多租户监控。

  • 运行与测试要点

    • 代码提供了一个完整的 MCP 服务端实现，并包含用于本地测试的 stdio 流传输、测试服务器以及综合测试用例。
    • 运行前请确保 Cloudflare 资源就绪（D1、KV、密钥、OAuth 等配置），并按仓库文档完成部署与测试。

  • 备注

    • 该实现包含完整的 MCP 协议处理、工具注册与调用，以及基于 JSON-RPC 的响应格式，符合 MCP 服务器的核心需求。

服务器信息

访问项目