适合谁
- 希望在 AI 编码环境中使用 Form.io 构建表单应用的开发者
- 需要标准化数据、RBAC 和审计功能的企业
- 使用 Claude Code 或兼容 MCP 的客户端的团队
F
Form.io Agentic Coding Toolset
官方
为 Form.io 项目提供 MCP 服务器、Claude Code 插件和 AI 技能库，让 AI 智能体无缝构建和管理表单。
GitHub 源仓库 ↗
62FMRS · C
福米奥的 AI 工具集是官方维护的项目，为 Form.io 平台提供了成熟的 MCP 集成。它包含丰富的工具和技能，支持从应用到表单的完整开发流程，并通过 Claude Code 插件提供便捷的安装体验。测试表明工具运行稳定，但需要用户具备 Form.io 项目权限。
Form.io Agentic Coding Toolset 是一个包含 MCP 服务器（@formio/mcp）、Claude Code 插件（@formio/ai）和 AI 技能库的完整工具集，旨在让开发者通过 AI 编码智能体（如 Claude Code）对 Form.io 企业服务器执行复杂的操作。它支持创建和管理表单、资源、角色、操作和项目，并提供丰富的技能库（如应用编排、表单构建、资源规划、Schema 编写等）来加速开发流程。该工具集将 Form.io 转为“可组合的后端”，使 AI 构建的应用能够直接利用其生产级的数据层、权限控制和审计基础设施。
工具能力
form_create
创建新表单。
form_get
按 ID 或路径获取单个表单定义。
form_list
列出表单，支持过滤和分页。
form_update
更新现有表单。
form_revisions_list
列出表单的只读发布版本摘要。
form_revision_get
获取单个只读表单版本。
role_create
创建新项目角色。
role_list
列出所有项目角色。
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
冒烟测试工具，返回静态问候语。
安装接入
- 安装 Claude Code。\n2. 在 Claude Code 中运行：/plugin marketplace add https://github.com/formio/ai.git\n3. 运行：/plugin install formio-ai@formio\n或者，您可以独立使用 MCP 服务器：在项目根目录创建 .mcp.json，并添加本配置。
claude_desktop_config.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"
}
}
}
}
选型与风险
不适合谁
- 不使用 Form.io 平台的开发者
- 需要无代码开发但无法使用 AI 编码工具的用户
- 需要一次性直接 REST API 访问但不通过 MCP 工具的场景
所需权限
- 需要 Form.io 项目的 API 密钥或浏览器登录认证
- 访问 Form.io 项目 URL 和基础 URL
- 能够创建、更新、删除表单、角色、操作和项目资源
风险与副作用
- API 密钥泄露可能导致未授权访问
- 导入项目模板时可能覆盖相同机器名的现有项目
- 在 CI 或没有显示的环境中，浏览器登录流程可能失败
- 使用不安全的 TLS 设置（FORMIO_INSECURE_TLS）可能存在问题
常见排障
- 确保设置正确的 FORMIO_BASE_URL 和 FORMIO_PROJECT_URL
- 如果使用 API 密钥，验证 FORMIO_API_KEY 是否有效
- 在 CI 环境中，如果无法进行浏览器登录，请设置 FORMIO_FORCE_BROWSER=1
- 检查网络是否能够访问 Form.io 部署
- 查看服务器日志是否有错误信息
使用场景
构建全新的基于表单的完整应用，如 CRM、帮助台、故事板等。
创建复杂的表单和多页条件向导，如大学申请向导、符合 FHIR 的患者表格。
在现有应用中嵌入和渲染 Form.io 表单。
通过提示直接使用 REST API 创建资源、表单或提交。
支持客户端
Claude Code完整支持
Claude Desktop完整支持
Cursor完整支持
VS Code Copilot完整支持
Windsurf完整支持
Cline完整支持