@dforge-core/dforge-mcp (英语)

DForge 模块作者的 MCP 服务器 。 展出35个可相容工具和可相容计划,使AI代理(Claude Code,Cursor,Zed等)能够驱动整个模块生命周期——脚手架 实体 动作 视图 安全 安装——通过结构化工具调用而不是自由形式JSON一代.

船舶 5种克洛德技能 (单位:千美元)skills/:路由器加每生命周期阶段1个技能——设计(第0阶段)、建造(第1-5阶段)和船舶(第6阶段)——和 dforge-1c-import 1C信息库的Python工具箱 路由器目录载有25个参考文件(字段类型,旗帜,特征,公式,DSL,安全等)和两个注解的示例模块.

新来的? 开始 文件/创建模块.md ——用三种方式来分解一个模块(terminal CLI,VS Code sidebar,AI 向导)和选择每个模块的时间.

两个GitHub重置要知道: 此 MCP 服务器位于 dforge-core/dforge-mcpdForge平台本身(实体、验证人、本地CLI源)位于 iash44/dForge-core - 参见 homepage 因为计划 + DSL 常规来自那里.

运行时间取决于什么

your AI editor (Claude Code / Cursor / Zed)
    │
    ▼ stdio JSON-RPC
@dforge-core/dforge-mcp       ← this package; pure JS / TS
    │
    ▼ shells out for pack / install
@dforge-core/dforge-cli        ← installed as a transitive dep; thin JS wrapper
    │
    ▼ optionalDependencies
@dforge-core/dforge-cli-<platform>   ← native C# binary per platform (~35 MB)

本地的二进制实际上与你的房客交谈。 npm-CLI包装器只是一个发射器,它选择了正确的平台二进制并执行. 您不需要单独安装 Dforge- cli ——当你安装dforge-mcp(或当 npx -y @dforge-core/dforge-mcp 运行冷.

服务器还捆绑 @dforge-core/metadata – 字段类型,特征,列类型和JSON schemas的无依赖性注册(dForge app,SDK,和VS代码扩展用法的同一套软件包). 这是以下作者时间验证的真相来源(有效) fieldTypeCd 编号 : columnType /特性代码, dbDatatype 和以物配主的计谋。 在建设时间被捆绑,所以没有额外的安装.

如果您想要使用手建的本地二进制, 而不是 npm 所发的, 点 DFORGE_CLI_BINARY 在可执行文件的绝对路径 :

DFORGE_CLI_BINARY=/Users/me/projects/dForge-core/cli/bin/dForge.Cli

(macOS / Linux:没有扩展名. 窗口 : dForge.Cli.exe. ) (中文(简体) ). 如果路径不存在或无法执行,服务器会在第一个包/安装调用时报告出错 .

对于AI辅助模块的修复,第6阶段是故意由工具驱动的:技能运行 dforge_module_validate, (中文(简体) ), dforge_module_pack,以及 dforge_module_install 自己来 如果由于模块无效而安装失败, 安装工具返回原始 CLI/ server 输出加 exitCode 财务报告和审定财务报表 command;AI读取了该输出,修正了被引用的模块文件,并重复验证了 → 包 → 安装. 仅需要用户对缺少CLI,缺失/过期证书,无法接触的租户/API,权限,或无效路径等环境故障采取行动.

将 + 线安装到 Claude 代码

建议——通过 claude mcp add (写~/.claude.json给你)

claude mcp add dforge --scope user -- npx -y @dforge-core/dforge-mcp

此附件为 ~/.claude.json (全局配置——您家目录中的单文件,无子目录). 重新启动 Claude 代码; 在启动服务器的第一个会话中, 您会看到“ 证明 MCP 服务器“ dforge ” —— 接受它 .

手册——每个项目

写入 .mcp.json 时间 重传根 (不低于 .claude/:

{
  "mcpServers": {
    "dforge": {
      "command": "npx",
      "args": ["-y", "@dforge-core/dforge-mcp"],
      "env": {
        "DFORGE_CLI_BINARY": "/optional/abs/path/to/dForge.Cli"
      }
    }
  }
}

恢复Claude代码 – 立即批准.

检查它还活着

claude mcp list
# Should show: dforge — npx -y @dforge-core/dforge-mcp — connected

或Claude代码会话内,类型 /mcp 查看所有连接的服务器 + 其工具。 第35条 dforge_* 应列出工具.

光标 / Zed

一样 command + args 配置形状; 检查文件文件位置 。 核查是通过其各自的工具清单进行的.

它会暴露什么

工具(34个)

按向导流中的典型相相组合. 所有“ 返回” 工具弹出 { summary, files: { '<relPath>': '<contents>' } };客户端决定是否写作——让AI预览diffs在承诺前与用户一起.

第0阶段(身份-要求-设计-验证)由 dforge_module_plan 工具与 dforge-mcp-author 技能:工具从上盘跟踪进度 docs/ 文物和大门的脚手架,而大赦国际则在其指导下编写这些文物.

模块级

实体(第一阶段)

综合实体工具(第1阶段)——每个概念一个调用,更喜欢这些

每一个都跨出数个协调键 手动组装出错 它们存在 所以断裂的形状是无法表达的.

外地/实体工具 @dforge-core/metadata 登记册:未知 fieldTypeCd (例如:. integer, (中文(简体) ), reference, (中文(简体) ), columnType,或特性代码在作者时被拒绝,并带有"你的意思"提示,以及 dbDatatype 是从字段类型(货币)自动生成的 numeric(18,2),文本 —— varchar; 引用/公式列没有),除非您明确设置.

行为(第2阶段——任择)

视图、菜单和报告(第3阶段)

波兰语( 第4阶段)

安保(第5阶段)

交叉

写入文件: 预览 vs apply

每个补丁工具返回 { summary, files, deletes? } 用于客户端写入,因此代理端可以先与用户预览diff. 通过 apply: true 而不是写文件(和荣誉) deletes直接返回,只返回被触碰的路径.

// preview (default) — full file contents come back through the model's context
{ "moduleDir": "/path/to/mod", "entityName": "order", "fieldName": "note", "field": { ... } }

// apply — writes to disk, returns { applied: true, written: [...], deleted: [...] }
{ "moduleDir": "/path/to/mod", "entityName": "order", "fieldName": "note", "field": { ... }, "apply": true }

使用 apply 用于已经批准的计划中的常规补丁,以及每个补丁 rename编号 :delete 重任——它保证 deletes 半则适用,这很容易手动下手。 它拒绝在外边写字 moduleDir,从不写 _inspect.json 编号 : _validate.json 编号 : _action_check.json 报告有效载荷,这些有效载荷只用于重用文件映射形状来运输.

资源

服务于MCP 并附有描述和MIME类型,因此代理在拉出前可以分辨出URI的用途.

Schemas + Conventions在从 iash44/dForge-core是因为 docs/出版的Npm 柏油丸将它们装入 resources/,而jsdelivr服务于他们:

https://cdn.jsdelivr.net/npm/@dforge-core/dforge-mcp@latest/resources/schemas/<name>.schema.json

兼容性 : 出柜的这个计划来自 iash44/dForge-core main 截至公布日期 package.json。如果平台在此发布后添加了新的实体属性/字段类型,使用这些特性生成的模块可能在当地验证,但在安装时被拒绝。 跳出dforge-mcp版本 当平台计划发生实质性变化时.

克洛德技能——路由器+三级技能

授权指导船为 4个 技能,按生命周期阶段划分。 每个阶段都需要另一半的知识库——第0阶段不需要任何外野型/DSL细节,第6阶段不需要任何取入式护栏——因此只有活性阶段才让一个上下文窗口内保存一个完整的模块构建.

交接是决定性的 dforge_module_plan({ action: "check" }) 返回时 currentPhase 财务报告和审定财务报表 nextSkill,来源于第0阶段文物,阶段分类账 docs/phase.json,从模块本身读取证据(没有字段的实体、没有视图的实体、没有选择赠款的实体).

路由器目录还持有共享资产:

技能不是自动安装的 npm install - 他们乘坐Npm的柏油球, 但克洛德代码看 ~/.claude/skills/没有 node_modules。使用安装器,它是一个节点脚本,所以它的行为完全相同 视窗 (cmd.exe / PowerShell), macOS, Linux, Git Bash 和 WSL数字 :

# Straight from the published package — no clone needed:
npx -y -p @dforge-core/dforge-mcp dforge-install-skills

# From a local checkout:
npm run install-skills

# Equivalently, without npm:
node scripts/install-skills.mjs [--from-npm]

目标解析, 顺序 : DEST → CLAUDE_CONFIG_DIR/skills → <home>/.claude/skills。主目录来自节点 os.homedir()因此,在视窗上它是 %USERPROFILE% 不管哪个贝壳引用它.

DEST=/path/to/skills npm run install-skills

它取代了每个技能目录批发——一个被留下的陈旧的参考文件比一个缺失的更糟糕,因为代理商会乐于写作反对.

每次Dforge-mcp升级后重新运行. 技能版在运行时不检查,因此与新工具相对抗的呆板技能会错传来电话.

关于CLAUDE.md的说明: 每个模块都有一个 CLAUDE.md 在其根中,在0a阶段(AI起草;您写出)中被编写,并保持后期状态完整. 它告诉Claude Code,目录是一个dForge模块,指向技能,描述模块布局,并搭载活 模块状态 跟踪器,所以未来的会话会准确恢复.

阶段:

技能中编码的关键原则:检查-先发制人,一发制人,复合工具-先发制人,在最早阶段-先发制人规则上确定后退道,一种工具失败协议,将认证/连接与模块缺陷区分开来,以及用户驱动的会后清理.

维护者

地方发展

pnpm install
pnpm build          # tsup → dist/server.js (bundles SDK + zod + dforge-cli/templates + metadata)
pnpm typecheck      # tsc --noEmit
pnpm test           # vitest — validation + dbDatatype derivation + trait flow
node dist/server.js # stdio JSON-RPC — pipe a request to smoke-test

以树为生 dforge-cli,暂时将解析器固定在双胞胎路径上:

sed -i '' 's|"@dforge-core/dforge-cli": "\^0.2.[0-9.]*"|"@dforge-core/dforge-cli": "file:../dforge-cli"|' package.json
rm -rf node_modules pnpm-lock.yaml && pnpm install
# Flip back before publish — file: deps don't resolve for npm consumers.

更新供应商资源

示马斯 (单位:千美元)resources/schemas/从安装中复制) @dforge-core/metadata 软件包 —— 碰上Dep 就是你如何选择变换方案。 他们通过 dforge://schema/* 并且,在公布的柏油球, 通过jsdelivr.

pnpm sync-schemas      # node script — cross-platform (Windows/macOS/Linux)

你很少用手操作这个: prepublishOnly 自动运行,因此,每一份出版物都会从这个软件包的精确元数据版本中重新产生这些计划——它们不能默默地漂移. 计划是坚定的,所以消费者总是有这些计划.

scripts/vendor-resources.sh 是一个Unix便利包装器,围绕相同的节点脚本,它还可以拉动 常规文献+技能参考文件 从 dForge-core - 但只有当 VENDOR_REFS=1数字 :

VENDOR_REFS=1 scripts/vendor-resources.sh   # also pull conventions + skill refs from ../dForge-core

裁判的拉票是故意的: 专题参考文献 skills/dforge-mcp-author/references/ 被写入此 repo 中并处于 dForge-core/skills/dforge-module-author/所以没有防守的拉能打倒他们 仅设定 VENDOR_REFS=1 一旦你确认核心 是那些档案的真相来源 (此部分只用bash; 在 Windows 上使用 WSL/ Git Bash 来进行 ref pub- schema re刷新通过 pnpm sync-schemas 属于本地。 )

出版

scripts/publish.sh 0.1.0-rc.N --tag latest --otp <code>

prepublishOnly 运行 tsup 所以,柏油丸得到新鲜的 dist/server.js。没有平台二进制管理.

打印前核对表 :

• @dforge-core/dforge-cli dep 是真实版本( 不是) file:...(中文(简体) )
• pnpm typecheck 通过
• pnpm test 通过
• 烟道测试: tools/list 返回 27 个工具
• 更新任何新/已更改工具的技巧( 这是 SIPARATE 的文物; 用户在升级后手动同步)

添加新工具

1. 放下来 src/tools/<name>.ts。使用共享助手从 src/tools/_helpers.ts (单位:千美元)loadManifest, (中文(简体) ), readJsonOrDefault, (中文(简体) ), jsonText, (中文(简体) ), makeResult, (中文(简体) ), withTodayStamp) (中文(简体) ). 还原 a ToolResult。 。 。 .
2. 导入 + 注册到 src/server.ts 通过 envelope() 包装.
3. 说吧 skills/dforge-mcp-author/SKILL.md (哪个阶段,哪个回溯方案使用它).
4. 弹出 package.json 版本,发布.

公约:

• 返回相对于模块根的文件映射 。 别给磁盘写信.
• 如果目标密钥已经存在, 则拒绝( 强制用户调用匹配) *_modify 编号 : *_remove) (中文(简体) ).
• 弹出 manifest.updated 在每一个补丁.

许可证

麻省理工学院.