@formhaus/mcp

中文文档
0.15.3发布于 2026/11/03MITTypeScriptES Module构建来源已验证近 30 天下载 8024

MCP服务器用于编写并检查Formhaus形式定义:验证,路径模拟和能力.

中文使用文档
文档目录3 节
  1. 设置
  2. 工具
  3. 许可证

@ formaus/ mcp (中文(简体) )

formhaus-dev/formhaus MCP server

允许 AI 代理检查的 MCP 服务器 福伦豪斯 形式定义相对于真实 @formhaus/core 发动机。 跑过Stdio。 要求节点22.12或更晚. 检查不需要账户或钥匙.

validate_definition, (中文(简体) ), fix_definition, (中文(简体) ), simulate_path, (中文(简体) ), translation_template, (中文(简体) ), capabilities 财务报告和审定财务报表 example_definitions 运行离线。 其他工具发布表格、阅读提交文件和管理设置 福尔豪斯云. 如果该应用程序有自己的后端,则保留该数据,未经用户同意不得发布.

设置

Claude 代码插件, 具有 Formhaus 技能 :

claude plugin marketplace add formhaus-dev/formhaus
claude plugin install formhaus@formhaus

在克劳德代码会话中, /plugin marketplace add formhaus-dev/formhaus 财务报告和审定财务报表 /plugin install formhaus@formhaus 在确认后做同样的事情.

Claude Code, 只有服务器:

claude mcp add formhaus -- npx -y @formhaus/mcp

Claude 桌面 (claude_desktop_config.json)和光标(.cursor/mcp.json:

{
  "mcpServers": {
    "formhaus": {
      "command": "npx",
      "args": ["-y", "@formhaus/mcp"]
    }
  }
}

工具

工具投入产出
validate_definitiondefinition (对象或JSON字符串){ valid, issues }每个问题都有: code, (中文(简体) ), severity一个JSON指针 path, (中文(简体) ), message, (中文(简体) ), hint 当有修行者知道的时候, fixes (单位:千美元){ title, safe, patch } 有RFC 6902 JSON补丁)
fix_definitiondefinition (对象或JSON字符串){ definition, applied, valid, issues }:每个安全装置都适用的定义、适用的固定装置和遗留的问题
simulate_pathdefinition, (中文(简体) ), answers选项 actions (单位:千美元)next, (中文(简体) ), back, (中文(简体) ), skip和 overlay有可见字段的主动步骤路径,动作跟踪, validation (单位:千美元){ valid, issues }),字段 errors, (中文(简体) ), wouldSubmit, (中文(简体) ), submitValues组合项目字段作为路径显示,例如 participants.0.email
capabilities无字段类型、段、可重复组、字段道具、验证规则、条件操作符、步骤和路由语义、翻译目录、密钥和重叠地址、适配器
translation_templatedefinition, (中文(简体) ), lang选项 prefixoverlay 建议使用源文本的模板 file 名称和 slots 有地址、钥匙、占位符和散列
example_definitions选项 id捆绑实例列表, 或一个定义
publish_formdefinition选项 form_id, (中文(简体) ), email, (中文(简体) ), success_message, (中文(简体) ), redirect_urlform_id, (中文(简体) ), endpoint, (中文(简体) ), hosted_url, (中文(简体) ), embed_snippet, (中文(简体) ), react_snippet, (中文(简体) ), dashboard_url, (中文(简体) ), warnings
list_forms无格式化 API 密钥到达状态、 版本、 提交数和终点
get_submissionsform_id选项 limit, (中文(简体) ), cursorsubmissions 财务报告和审定财务报表 next_cursor
update_form_settingsform_id选项 webhook_url, (中文(简体) ), notify_mode, (中文(简体) ), success_message, (中文(简体) ), redirect_url, (中文(简体) ), statusform_id, (中文(简体) ), status, (中文(简体) ), success_message, (中文(简体) ), redirect_url, (中文(简体) ), notify_mode, (中文(简体) ), webhook_url遮盖 webhook_secret
get_webhookform_idurl 和被蒙上头罩 secret
reveal_webhook_secretform_idform_id 和全文 webhook_secret。标记为一个不只读而敏感的工具。 客户端是否首先询问取决于其权限设置

publish_form, (中文(简体) ), list_forms, (中文(简体) ), get_submissions, (中文(简体) ), update_form_settings, (中文(简体) ), get_webhook 财务报告和审定财务报表 reveal_webhook_secret 呼叫云层 https://api.formhaus.dev。 。 。 publish_form 需求 FORMHAUS_API_KEY 在服务器环境中,以及 publish_form 设定时使用。 账户密钥( E)fh_live_...)达到每一种形式和所有六种工具. 一个代理密钥( A)fh_agent_...,第一个无键返回一次 publish_form只能达到它创造的形式 update_form_settings, (中文(简体) ), get_webhook 财务报告和审定财务报表 reveal_webhook_secret 需要一个账户密钥。 服务器读取 FORMHAUS_API_KEY 从自己的环境,而不是从项目 .env添加到 env 在您的 MCP 客户端配置中的窗体服务器( 例如) .mcp.json 与 ${FORMHAUS_API_KEY} 和您外壳中的值或被忽略的值 .env 然后重新启动服务器. FORMHAUS_API_BASE 覆盖 API URL。 服务器还在连接时向客户端发送了简短的使用指令.

simulate_path 应用 answers 作为初始值,将组合答案作为项目对象的数组,然后按顺序排列动作,或直到最后一步或第一个阻断错误. errors 仅涵盖访问的步骤。 自定义验证符, onStepValidate 和生命周期悬钩没有运行。 这些能力也可用于: formhaus://capabilities 资源.

工具处理器导出用于不使用 MCP :

import { simulatePathTool, validateDefinitionTool } from '@formhaus/mcp';

const report = await validateDefinitionTool({ definition });
const result = await simulatePathTool({ definition, answers: { kind: 'business' } });

见 MCP 指南 例如输出。 A 类 远程 MCP 服务器 因为Formhaus Cloud也可用. npx formhaus 在机器上的编码代理设置服务器;见 formhaus。 。 。 .

许可证

麻省理工学院

版本与发布记录

@formhaus/mcp 共发布 55 个版本,首次发布于 2026/10/09;过去 12 个月发布了 55 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.15.3latest2026/11/0313 天前
0.15.22026/11/0313 天前
0.15.12026/11/0213 天前
0.15.02026/11/0213 天前
0.14.02026/11/0213 天前
0.13.32026/11/0114 天前

关于 @formhaus/mcp 的常见问题

@formhaus/mcp 是什么?

MCP服务器用于编写并检查Formhaus形式定义:验证,路径模拟和能力.

如何安装 @formhaus/mcp?

在项目目录运行 npm install @formhaus/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 formhaus-mcp,可以用 npx formhaus-mcp 直接运行。

@formhaus/mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@formhaus/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@formhaus/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@formhaus/mcp 可以商用吗?

@formhaus/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@formhaus/mcp 的下载量有多少?

根据 npm 官方下载统计,@formhaus/mcp 在 2026/10/16 – 2026/11/14 这 30 天内被下载 8,024 次,日均约 267 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@formhaus/mcp 还在维护吗?

最新版本 0.15.3 发布于 2026/11/03(13 天前);至今共发布 55 个版本,其中过去 12 个月发布了 55 个;首次发布于 2026/10/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。