关于 Formfeed
Formfeed 的 MCP 服务让 Agent 管理文档模板、验证数据、渲染 PDF 和图像,并将 Office 文档转换为 PDF。它支持离线验证和发票检查;模板变更会保存为草稿,需由人员发布。
主要功能
- 01列出模板并查看其架构
- 02验证模板数据及离线 HTML
- 03检查 ZUGFeRD 和 Factur-X 发票数据
- 04从模板渲染 PDF 或图像
- 05将 Office 和 OpenDocument 文件转为 PDF
- 06将模板变更保存为草稿
适用场景
- 01在渲染文档前验证数据
- 02依据 EN 16931 检查电子发票
- 03生成 PDF 或查看渲染图像
- 04将 Word、Excel 或 PowerPoint 文件转为 PDF
MCP 相关
通过 stdio 或托管的 Streamable HTTP 向 MCP 客户端提供十种工具。认证可使用 API 密钥或 Formfeed 账户登录;不提供密钥时仍可使用离线验证工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.formfeed.dev/mcpclaude mcp add --transport http formfeed-dev-formfeed https://mcp.formfeed.dev/mcp{"mcpServers":{"formfeed-dev-formfeed":{"type":"http","url":"https://mcp.formfeed.dev/mcp"}}}在 Cursor 中打开{"servers":{"formfeed-dev-formfeed":{"type":"http","url":"https://mcp.formfeed.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"formfeed-dev-formfeed":{"type":"http","url":"https://mcp.formfeed.dev/mcp"}}}{"mcpServers":{"formfeed-dev-formfeed":{"serverUrl":"https://mcp.formfeed.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.formfeed.dev/mcp需要授权https://mcp.formfeed.dev/mcp/{workspace_id}工具
详细介绍
@formfeed/mcp
适用于 Formfeed 的 Model Context Protocol 服务。
为 Claude、Cursor 和其他 Agent 提供 10 个工具:list_templates、get_template_schema、
validate_template(免费:根据模板架构验证数据,支持离线验证临时 HTML)、check_invoice(免费且离线:根据 EN 16931 检查 ZUGFeRD / Factur-X 电子发票的
_invoice 区块)、render(使用 einvoice 时,PDF 会成为该电子发票;图像会以图片形式返回,供 Agent 查看)、
convert_to_pdf(将 Word、Excel、PowerPoint 和 OpenDocument 转换为 PDF)、get_render、get_workspace(服务运行所在的工作区以及剩余单位数)、get_template_source 和 save_template(创建新模板或将更改保存为草稿,由用户在 Formfeed 中发布;密钥需要具备 template:write 权限,已登录的 Agent 则需要具备用户的权限)。
stdio(Claude Desktop、Cursor、Claude Code)
{
"mcpServers": {
"formfeed": {
"command": "npx",
"args": ["-y", "@formfeed/mcp"],
"env": { "FORMFEED_API_KEY": "ff_test_…" }
}
}
}
测试密钥可免费渲染(Free 方案会带有测试标记);正式密钥会消耗单位。
未设置 FORMFEED_API_KEY 时,服务也会启动,但仅提供离线检查:validate_template
(搭配 html 和 engine)以及 check_invoice。设置 FORMFEED_REGION=us 或 FORMFEED_BASE_URL 可选择其他 API 主机。
托管式(Streamable HTTP)
https://mcp.formfeed.dev/mcp 接受 Authorization: Bearer ff_…,也可在未发送密钥时使用 Formfeed 账户登录(OAuth;客户端会打开浏览器,由你选择 Agent 使用的工作区)。https://mcp.formfeed.dev/mcp/<workspace id> 可为已登录的客户端固定到其他工作区。使用 formfeed-mcp --http --port 8790 自托管相同的端点;如需通过你自己的 Supabase Auth 进行 OAuth 登录,还需添加 --auth-server <issuer>。
Claude Code 会从 formfeed-dev/skills 安装托管服务和两个用于编写、检查模板的技能,作为 Formfeed 插件: https://docs.formfeed.dev/devkit/coding-agents
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。