Form.io Agentic Coding Toolset

官方

为 Form.io 项目提供 MCP 服务器、Claude Code 插件和 AI 技能库，让 AI 智能体无缝构建和管理表单。

分类: 开发工具第 95 / 438
Stars: ★ 8 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 可选 API Key
许可证: MIT
最近提交: 10 天前
工具数: 20

62FMRS · C

福米奥的 AI 工具集是官方维护的项目，为 Form.io 平台提供了成熟的 MCP 集成。它包含丰富的工具和技能，支持从应用到表单的完整开发流程，并通过 Claude Code 插件提供便捷的安装体验。测试表明工具运行稳定，但需要用户具备 Form.io 项目权限。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

13/20

维护活跃度

11/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 中记录了 CI 徽章并引用了技能测试套件，但未提供实际的测试文件或 CI 工作流内容，因此根据静态校准规则无法验证关键路径的执行证据。工具清单（form_*、role_*、action_*、project_*、hello）在内部是一致的，并且错误/回退行为有文档记录（登录表单探测超时、项目来源优先级），但没有任何已提交的测试证明工具行为与文档一致，因此将得分限制在 10 左右。
安全与权限 13/20: FORMIO_API_KEY 被正确标记为 isSecret: true，浏览器 JWT 流程避免了长期凭证存储，并且 FORMIO_INSECURE_TLS 被记录为仅限开发使用。但是，FORMIO_INSECURE_TLS 会全局设置 NODE_TLS_REJECT_UNAUTHORIZED=0，如果误用会有风险；project_import 会静默覆盖同名项目且没有确认步骤，而 action_delete 和 role_update（完全替换）没有记录的确认机制；基于浏览器的登录流程和登录表单自动探测会引入网络端点，这些点仅做了部分披露。未发现危险默认设置、恶意软件或外泄等红线问题，因此得分保持在 10 以上，但因确认/权限限制不完整而未获更高分数。
维护活跃度 11/20: MIT 许可证、SECURITY.md、CONTRIBUTING.md、版本化的 npm 包 (0.12.3) 以及清单/包版本对齐表明治理规范。然而，仅可见 6 个 star 和 1 个未解决问题；无法从提供的静态材料中验证发布节奏、提交活动或依赖更新。版本一致性良好，但持续维护的证据有限。
文档质量 15/20: 分层、详尽的文档：各客户端的安装表格、身份验证模式、环境变量表格及示例、登录表单解析顺序、工具表，以及带已知限制披露的示例提示词（例如，仅限 Angular 的 greenfield、没有技能时的护栏、项目 URL 优先级）。在静态审查中无法验证故障排除证据，且一些假设（插件与独立模式的差异）增加了复杂性，因此未获得满分。
安装易用性 13/20: 多路径入门指南：Claude Code 插件单命令安装、Cursor/VS Code 的一键安装链接、手动 mcp. 覆盖五个客户端，以及已发布的 npm 包。通过 env 提供占位符配置。扣分点：FORMIO_BASE_URL/PROJECT_URL 在独立模式下被声明为必需，但在清单中却是可选，且存在浏览器登录前提条件，增加了设置脆弱性；在提供的文件中未验证平台/运行时兼容性测试。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

希望在 AI 编码环境中使用 Form.io 构建表单应用的开发者
需要标准化数据、RBAC 和审计功能的企业
使用 Claude Code 或兼容 MCP 的客户端的团队

不适合谁

不使用 Form.io 平台的开发者
需要无代码开发但无法使用 AI 编码工具的用户
需要一次性直接 REST API 访问但不通过 MCP 工具的场景

所需权限

需要 Form.io 项目的 API 密钥或浏览器登录认证
访问 Form.io 项目 URL 和基础 URL
能够创建、更新、删除表单、角色、操作和项目资源

风险与副作用

API 密钥泄露可能导致未授权访问
导入项目模板时可能覆盖相同机器名的现有项目
在 CI 或没有显示的环境中，浏览器登录流程可能失败
使用不安全的 TLS 设置（FORMIO_INSECURE_TLS）可能存在问题

安装接入

准备工作

运行环境：Node.js

FORMIO_API_KEY 可选密钥 Form.io 项目 API 密钥（可选）；设置后跳过浏览器登录流程，在项目的 API 密钥设置中获取。

其他可选配置项（6 个）

FORMIO_BASE_URL 可选 Form.io 部署的基础 URL，例如托管 SaaS 用 https://api.form.io，自托管用 https://forms.example.com；通常可从项目 URL 推导，非必需。

FORMIO_PROJECT_URL 可选 Form.io 项目的完整 URL，如 https://myproject.form.io（SaaS）或 https://forms.example.com/myproject（自托管）；也可由 formio. 或 project_set 映射提供。

FORMIO_LOGIN_FORM 可选自定义门户登录表单的 URL（可选）；不设置时服务器会自动探测候选登录表单。

FORMIO_FORCE_BROWSER 可选设为 1 强制尝试浏览器登录，用于 CI、容器等无法本地展示浏览器的环境。

FORMIO_INSECURE_TLS 可选设为 1 跳过 TLS 证书验证（NODE_TLS_REJECT_UNAUTHORIZED=0），仅用于自签名证书的本地开发，切勿在生产环境使用。

FORMIO_PLUGIN_CONTEXT 可选由插件清单自动设置；为 1 时启用 project_set 工具并按工作目录读取 ~/.formio/projects.。

安装 Claude Code。\n2. 在 Claude Code 中运行：/plugin marketplace add https://github.com/formio/ai.git\n3. 运行：/plugin install formio-ai@formio\n或者，您可以独立使用 MCP 服务器：在项目根目录创建 .mcp.json，并添加本配置。

.mcp.json

{
  "mcpServers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_BASE_URL": "https://api.form.io",
        "FORMIO_PROJECT_URL": "https://your-project.form.io"
      }
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "formio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@formio/mcp"
      ],
      "env": {
        "FORMIO_BASE_URL": "https://api.form.io",
        "FORMIO_PROJECT_URL": "https://your-project.form.io"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add formio-mcp -e FORMIO_BASE_URL=https://api.form.io -e FORMIO_PROJECT_URL=https://your-project.form.io -- npx -y @formio/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中调用 hello 冒烟测试工具，确认返回问候语说明 MCP 连接正常；首次经过身份验证的工具调用会触发浏览器登录流程。

常见排障

确保设置正确的 FORMIO_BASE_URL 和 FORMIO_PROJECT_URL
如果使用 API 密钥，验证 FORMIO_API_KEY 是否有效
在 CI 环境中，如果无法进行浏览器登录，请设置 FORMIO_FORCE_BROWSER=1
检查网络是否能够访问 Form.io 部署
查看服务器日志是否有错误信息

试试这样问

连接成功后，可以直接对 AI 助手这样说：

使用 formio-mcp 工具列出我的 Form.io 项目中的所有表单和角色，然后把完整项目模板导出并保存到 ./backup/template.。
使用 formio-mcp 的 form_create 工具创建一个名为“Contact Us”的表单，包含姓名（必填）、邮箱（必填）、主题、留言字段和一个提交按钮。
列出我的 Form.io 项目中所有可用的 action 类型及其设置。
把这个项目的角色和表单模板导入到我的另一个项目里。

工具能力 20

form_create 写入

创建新表单。

form_get 只读

按 ID 或路径获取单个表单定义。

form_list 只读

列出表单，支持过滤和分页。

form_update 写入

更新现有表单。

form_revisions_list 只读

列出表单的只读发布版本摘要。

form_revision_get 只读

获取单个只读表单版本。

role_create 写入

创建新项目角色。

role_list 只读

列出所有项目角色。

展开其余 12 个工具

role_update 写入

全量替换更新角色。

action_types_list 只读

列出服务器上可用的所有操作类型。

action_type_get 只读

获取操作类型的设置 schema。

action_create 写入

向表单附加新操作。

action_list 只读

列出表单上的操作。

action_get 只读

按 ID 获取单个操作。

action_update 写入

更新操作。

action_delete 破坏性

从表单取消附加操作。

project_export 只读

导出项目的完整模板（角色、资源、表单、操作）为可移植的 JSON。

project_import 写入

导入模板 JSON，增量合并角色、资源、表单和操作。

project_set 写入

插件模式专属：持久化每目录的项目 URL 映射。

hello 只读

冒烟测试工具，返回静态问候语。

使用场景

构建全新的基于表单的完整应用，如 CRM、帮助台、故事板等。

创建复杂的表单和多页条件向导，如大学申请向导、符合 FHIR 的患者表格。

在现有应用中嵌入和渲染 Form.io 表单。

通过提示直接使用 REST API 创建资源、表单或提交。

支持客户端

Claude Code

Claude Desktop

Cursor

VS Code

Windsurf

Cline

依据项目文档列出，未经本站实测。

详细介绍

Form.io Agentic Coding Toolset 是一个包含 MCP 服务器（@formio/mcp）、Claude Code 插件（@formio/ai）和 AI 技能库的完整工具集，旨在让开发者通过 AI 编码智能体（如 Claude Code）对 Form.io 企业服务器执行复杂的操作。它支持创建和管理表单、资源、角色、操作和项目，并提供丰富的技能库（如应用编排、表单构建、资源规划、Schema 编写等）来加速开发流程。该工具集将 Form.io 转为“可组合的后端”，使 AI 构建的应用能够直接利用其生产级的数据层、权限控制和审计基础设施。