VA表单生成MCP服务器
用于VA表单生成自动化的外部MCP服务器 -与VA代码库完全分离，适用于任何兽医网站工作区。
🎯 目的
此MCP服务器提供用于审核和修复脚手架VA表单的工具和资源，以确保它们遵循21P-601最佳实践和VA.gov内容标准。
主要优势：
- ✅ 外部 -居住在VA仓库之外，无需代码审查
- ✅ 可重复使用的 -适用于任何兽医网站工作区
- ✅ 团队友好 -在整个团队中共享
- ✅ 版本受控 -单独跟踪改进
______________________________________________________________________
🚀 快速开始
1.安装
cd ~/va-form-generation-mcp
npm install2.配置您的Claude环境
选择您使用的平台：
🖥️ 克劳德桌面
添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"va-form-generation": {
"command": "node",
"args": [
"/Users/YOUR_USERNAME/va-form-generation-mcp/index.js"
]
}
}
}替换 YOUR_USERNAME 使用您的真实用户名！
然后重新启动克劳德桌面 -MCP服务器将自动连接。
______________________________________________________________________
💻 克劳德代码（VS代码扩展）
创建或更新 .mcp.json 在你的 vets网站工作区根目录:
{
"mcpServers": {
"va-form-generation": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/va-form-generation-mcp/index.js"]
}
}
}同时更新 .claude/settings.local.json 启用MCP服务器：
{
"permissions": {
"allow": [
"Read(//Users/YOUR_USERNAME/va-form-generation-mcp/**)"
]
},
"enableAllProjectMcpServers": true
}然后重新加载您的VS Code窗口 -Claude Code将检测并加载MCP服务器。
______________________________________________________________________
🔍 游标（游标中的克劳德代码）
与上面的Claude代码相同-创建 .mcp.json 在您的工作区根目录中进行更新 .claude/settings.local.json.
然后重新加载光标 以激活MCP服务器。
______________________________________________________________________
💬 ChatGPT
ChatGPT目前不支持MCP服务器。但是，您可以：
- 从以下位置复制模板
~/va-form-generation-mcp/templates/ - 将它们直接粘贴到ChatGPT对话中
- 或使用GPT操作（需要具有API访问权限的自定义GPT）
______________________________________________________________________
3.验证设置
在克劳德桌面、克劳德代码或光标中：
Show me all available tools from the va-form-generation MCP server您应该看到列出了5个工具。
4.使用它！
Use the va-form-generation MCP server to audit form 21p-0516 in /Users/aponce/Workspaces/vets-website______________________________________________________________________
🛠️ 可用工具
audit_form
为脚手架表格生成全面的审计报告。
用途：
Audit form 21p-0516 using the MCP server
Workspace: /Users/aponce/Workspaces/vets-website退货：
- 表单信息
- 代理执行计划
- 预期修复
- 快速启动命令
______________________________________________________________________
get_agent_prompt
获取特定代理的自定义提示（1-4）。
用途：
Get Agent 2 prompt for form 21p-0516退货：
- 该代理的专业提示
- 使用特定于表单的路径进行定制
- 准备执行
______________________________________________________________________
validate_form
运行验证检查（模式、语法、撇号、导入）。
用途：
Validate form at /path/to/form checking schema and apostrophes退货：
- 运行验证的Bash命令
- 预期发现的问题
______________________________________________________________________
get_fix_reference
获取常见修复程序的快速参考。
用途：
Show me the yesNoUI fix reference选项：
yesNoUI-如何修复yesNoUI模式radioSchema-如何修复radioSchema调用apostrophes-如何修正撇号语法transformers-如何修复提交/预充变压器fullNamePath-如何添加fullNamePath（关键！）all-显示所有修复
______________________________________________________________________
generate_orchestration_prompt
生成完整的编排提示以启动所有4个代理。
用途：
Generate orchestration prompt for form 21p-0516退货：
- 完成启动所有4个代理的提示
- 分阶段执行计划
- 预期结果
______________________________________________________________________
📚 可用资源
checklist://master
完成表单生成的主检查表。
template://agent-1 通过 template://agent-4
为4名代理人分别提供专门的提示。
reference://fixes
所有16个修复的前/后示例。
______________________________________________________________________
🎯 典型工作流程
选项1：全自动化
Use the va-form-generation MCP server to:
1. Audit form 21p-0516 in /Users/aponce/Workspaces/vets-website
2. Generate the orchestration prompt
3. Execute all 4 agents选项2：逐步
1. Audit form 21p-0516 using MCP server
2. Get Agent 1 prompt from MCP server
3. Get Agent 2 prompt from MCP server
4. Get Agent 3 prompt from MCP server
5. Get Agent 4 prompt from MCP server选项3：仅验证
Use MCP server to validate form 21p-0516 for all check types______________________________________________________________________
🏗️ 建筑
┌─────────────────────────────────────┐
│ Claude Desktop / Claude Code │
└──────────────┬──────────────────────┘
│ MCP Protocol
┌──────────────▼──────────────────────┐
│ VA Form Generation MCP Server │
│ (External - ~/va-form-generation) │
│ │
│ Tools: │
│ ✓ audit_form │
│ ✓ get_agent_prompt │
│ ✓ validate_form │
│ ✓ get_fix_reference │
│ ✓ generate_orchestration_prompt │
│ │
│ Resources: │
│ ✓ Master checklist │
│ ✓ Agent prompts (1-4) │
│ ✓ Fix references │
└──────────────┬──────────────────────┘
│ File System Access
┌──────────────▼──────────────────────┐
│ vets-website Workspace │
│ /Users/aponce/Workspaces/... │
└─────────────────────────────────────┘______________________________________________________________________
📦 什么得到修复
组件模式（6个修复）
✅ yesNoUI简化为 yesNoUI('question') ✅ 导入路径已更正 ✅ 用枚举值调用radioSchema ✅ 已删除重复导入
架构（5次修复）
✅ 引言页面已重写 ✅ 确认页面使用确认视图 ✅ 提交变压器遵循21P-601 ✅ 预填充变压器访问配置文件 ✅ form.js具有fullNamePath
内容（3次修复）
✅ 简明语言（你/我们，缩写） ✅ 以人为中心的标题 ✅ PDF精确标签
语法（2次修复）
✅ 严重错误 ✅ 架构验证
总计：16+个自动修复
______________________________________________________________________
🔧 发展
在开发模式下运行
npm run dev添加新工具
编辑 index.js 并添加到 tools 数组 ListToolsRequestSchema 处理程序。
添加新资源
编辑 index.js 并添加到 resources 数组 ListResourcesRequestSchema 处理程序。
更新模板
编辑文件 templates/ 目录。
______________________________________________________________________
📖 例子
示例1：快速审核
I'm working on form 21p-0516. Use the MCP server to audit it and tell me what needs to be fixed.
Workspace: /Users/aponce/Workspaces/vets-website示例2：获取特定修复
Use the MCP server to show me how to fix the radioSchema pattern示例3：全自动化
Use the MCP server to:
1. Audit form 21p-527ez
2. Generate the orchestration prompt
3. Launch all 4 agents in the correct order
Workspace: /Users/aponce/Workspaces/vets-website示例4：验证
Use the MCP server to validate form 21p-0516 for schema errors and apostrophe syntax
Form path: /Users/aponce/Workspaces/vets-website/src/applications/simple-forms/21p-0516______________________________________________________________________
🎓 了解更多
- 主检查表：
templates/master-checklist.md - 代理人提示：
templates/agent-{1-4}-prompt.md - MCP协议： https://modelcontextprotocol.io/
______________________________________________________________________
🚢 与团队分享
方法1:Git仓库
cd ~/va-form-generation-mcp
git init
git add .
git commit -m "Initial MCP server"
git remote add origin YOUR_REPO_URL
git push -u origin main团队成员克隆和配置：
git clone YOUR_REPO_URL ~/va-form-generation-mcp
cd ~/va-form-generation-mcp
npm install
# Add to claude_desktop_config.json方法2：npm包（私有注册表）
npm publish --registry YOUR_PRIVATE_REGISTRY团队成员安装：
npm install -g va-form-generation-mcp --registry YOUR_PRIVATE_REGISTRY______________________________________________________________________
❓ 常见问题解答
Q： 这会修改兽医网站的回购吗？
A. 不！MCP服务器完全位于VA仓库之外。它只提供工具和提示——克劳德负责实际的修改。
Q： 多人可以使用这个吗？
A. 对！每个团队成员单独安装它，并将其指向自己的兽医网站工作区。
Q： 如果退伍军人事务部改变了他们的模式怎么办？
A. 更新此仓库中的模板。每个人都会查看更新。无需VA PR！
Q： 我可以定制吗？
A. 当然！编辑模板或添加特定于您需求的新工具。
Q： 它在VS Code中与Claude Code一起工作吗？
A. 对！只要Claude Code支持MCP服务器，它就可以工作。
______________________________________________________________________
📝 许可证
麻省理工学院
______________________________________________________________________
问题？ 打开一个问题或问Claude：“解释va表单生成MCP服务器”