Re:port Flow MCP

官方显示名称：Re:port Flow MCP。包和实现标识符：reportflow-mcp。旧版搜索别名：ReportFlow MCP Server 和 ReportFlow。

概述

一个 MCP（模型上下文协议）服务器，可将您的 Re:port Flow 模板转换为 PDF 报告 — 发票、合同、对账单，以及您设计的任何内容 — 直接通过 Claude 或任何其他兼容 MCP 的 AI 智能体生成。

Related MCP server: PDF Tools AI MCP

功能

• 根据自然语言请求生成 PDF，例如 "为 Acme Corp 创建一张总计 300 美元的发票"

• 将您的 Re:port Flow 设计和其参数模式直接作为 MCP 资源 暴露给 AI

• 批量生成多个 PDF 并作为单个 ZIP 下载

• 将输出保存到用户当前所在的任何工作区文件夹（支持 Claude Desktop / Claude Code / Cursor / VS Code）

设置

Re:port Flow MCP 以两种方式运行 — 选择适合您客户端的一种。

远程服务器（claude.ai / Web 客户端）— Streamable HTTP

将 Re:port Flow 添加为指向托管端点的自定义连接器：

https://mcp.re-port-flow.com/mcp

在 Claude (claude.ai) 中，转至 设置 → 连接器 → 添加自定义连接器，然后粘贴上面的 URL。身份验证通过应用内 OAuth 处理（请参阅 身份验证）— 无需在本地安装任何内容。

本地服务器（Claude Desktop / Claude Code / Cursor）— 通过 npx 使用 stdio

将以下内容添加到您的配置文件中（.mcp.json、claude_desktop_config.json、~/.cursor/mcp.json 等）：

{
  "mcpServers": {
    "reportflow": {
      "command": "npx",
      "args": ["-y", "reportflow-mcp"]
    }
  }
}

这就是全部设置。无需管理环境变量、API 密钥或机密。

VS Code（支持 MCP 的版本）

在 .vscode/mcp.json 中使用相同的 JSON。

要求

• 远程：支持自定义 HTTP 连接器的 MCP 客户端（例如 claude.ai）。无需本地安装。

• 本地 (stdio)：Node.js 22+（由 npx 自动获取），并且首次登录期间需要有可用的浏览器。

• 一个 Re:port Flow 帐户（无论哪种方式）。

支持的协议修订版本

两种传输方式（stdio / Streamable HTTP）均从单个端点提供两代 MCP 协议：

• 2026-07-28（当前）— 无状态的按请求协议。现代客户端通过 server/discover 发现它；没有会话标头，请求在 _meta 中携带其协议版本。

• 2025 时代的修订版（2025-11-25、2025-06-18、2025-03-26、2024-11-05、2024-10-07）— 经典的 initialize 握手，保留用于与现有客户端（Claude Desktop、claude.ai 自定义连接器、Cursor、ChatGPT、n8n 等）向后兼容。

版本选择在两种传输方式上都是自动的：现代客户端使用 server/discover 探测，旧客户端继续发送 initialize — 双方均无需配置，现有连接将保持不变地继续工作。

身份验证

远程（claude.ai）

当您添加连接器时，Claude 会为您运行 OAuth 流程：登录 → 选择工作区 → 同意。令牌由客户端持有 — 无需管理本地钥匙串或浏览器步骤。

本地 (stdio)

重新加载 MCP 客户端后，向 AI 发出请求：

使用 Re:port Flow 进行身份验证

浏览器窗口将打开。登录 → 选择工作区 → 同意，然后就可以了。令牌存储在您的操作系统钥匙串中（macOS 钥匙串 / Windows 凭据管理器 / Linux libsecret），并提供 chmod-0600 文件回退，并且会自动刷新。

使用示例

下面的每个示例都是您可以原样粘贴的提示；AI 会选择正确的工具。

1. 生成单个 PDF（列表 → 模式 → 生成）

使用发票模板，为 Acme Corp 创建一份总计 330 美元的 PDF。

AI 使用 list_templates 列出设计，使用 get_design_parameters 获取参数模式，填写数值，并调用 generate_pdf_sync。

• 远程：返回下载 URL（fileUrl）。

• 本地：还会保存文件并返回其绝对路径。

2. 批量生成多个 PDF

从对账单模板中，为每位客户生成一份 PDF （Acme 100 美元、Globex 250 美元、Initech 80 美元），然后将它们一起给我。

• 本地 (stdio)：generate_pdfs_sync 将单个 ZIP 写入您的工作区。

• 远程：generate_pdfs_async 运行批次并返回请求 ID 以及下载 URL。

3. 异步生成，然后下载（本地）

在后台启动合同 PDF，然后在其就绪后下载。

AI 调用 generate_pdf_async（立即返回 requestId），然后调用 download_file 保存完成的 PDF。批次对应的是 generate_pdfs_async → download_zip。这些下载工具仅适用于 stdio；在远程服务器上，同步/异步工具已经返回 fileUrl。

提示 — 自然语言参数： 在支持 Sampling 的客户端上，您可以要求 "为开给 A社 的 1,000 美元发票草拟参数"，AI 将调用 suggest_params，在生成之前将简要说明转换为有效的 params 对象。

4. 从零模板开始（模板库 → 复制 → 生成）

我还没有任何模板 — 为 Acme Corp 创建一张发票 PDF。

当 list_templates 为空时，AI 使用 search_gallery_templates 搜索公共模板库，向您展示候选模板，使用 copy_gallery_template 将您选择的模板复制到您的工作区，然后继续正常流程（get_design_parameters → generate_pdf_sync）。复制的内容始终会放入您在 OAuth 同意屏幕上选择的工作区 — AI 无法定位到任何其他工作区。

斜杠命令

文件保存位置（本地模式）

输出位置按以下顺序解析：

1. 用户的明确指示（例如 "保存到我的桌面"）

2. 当前打开的工作区根目录（Claude Code / Cursor / VS Code）

3. 作为备用的操作系统临时目录

参考

工具（由 AI 调用）

资源（可作为 AI 上下文附加）

提示词（斜杠命令配方卡）

/generate_pdf、/generate_pdfs、/reportflow_help — 传递参数后，AI 会遵循预定的工作流程。

故障排除

隐私

Re:port Flow MCP 是一个轻量客户端：它将你的请求转发到你自己的 Re:port Flow 账户，并返回生成的 PDF。它不会向第三方出售或共享你的数据。认证令牌存储在本地（操作系统钥匙串，或 chmod-0600 文件的回退方案），并且只发送给 Re:port Flow 自己的服务——在 OAuth 登录期间，以及作为每次认证 API 调用（列出模板、生成或下载 PDF）的 Bearer 凭据。它们绝不会与任何第三方共享。

有关完整隐私政策——收集哪些信息、保留多长时间以及如何处理——请参阅：lp.re-port-flow.com

安全性

托管端点根据 MCP Streamable HTTP 规范的安全要求验证 Host 头（DNS 重新绑定保护），并以 403 Forbidden 拒绝结构无效的 Origin 头。认证仅使用 Bearer 令牌——不使用 Cookie，并且 CORS 从不允许凭据。完整策略及其威胁模型记录在 docs/security.md（日语）中。

支持

需要帮助、发现 Bug，或对目录审查有疑问？

• Re:port Flow（隐私与支持）：https://lp.re-port-flow.com

• GitHub Issues：https://github.com/re-port-flow/reportflow-mcp/issues

许可证

MIT — 参见 LICENSE。

链接

• Re:port Flow：https://re-port-flow.com

• 隐私与支持：https://lp.re-port-flow.com

• npm：https://www.npmjs.com/package/reportflow-mcp

• Issues：https://github.com/re-port-flow/reportflow-mcp/issues