mcpField
O
OpenMEP duct sizing

OpenMEP duct sizing

本地服务
github.com/samarmstrong科研与教育03 周前更新

关于 OpenMEP duct sizing

OpenMEP duct sizing 是面向 Agent 和 HVAC 工程师的 MCP 服务,可按固定等摩擦率或 Manual D 速率确定风管尺寸并评估现有风管。它将风量作为输入,结果供工程师初步审核。

主要功能

  1. 01计算单段风管尺寸
  2. 02分析相连风管网络
  3. 03采用 Manual D 摩擦率
  4. 04评估现有风管
  5. 05标记网络与尺寸问题

适用场景

  1. 01根据设计风量选择风管尺寸
  2. 02审核现有风管尺寸
  3. 03依据风机静压检查风管网络

MCP 相关

向 MCP 客户端提供 `size_duct` 和 `size_duct_network` 工具。工具为只读操作,返回尺寸建议、评级和问题发现。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"samarmstrong-openmep": {
"command": "npx",
"args": [
"-y",
"@openmep/mcp"
]
}
}
}
启动命令npx -y @openmep/mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@openmep/mcp0.2.0

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
cfmnumber是该风管段承载的风量,单位为 CFM。
roleenum否main(设备处)、branch(服务多个末端)或 runout(一个末端)。默认值为 main。main | branch | runout
existingany否用于评估的现有截面:圆形使用 { diameterIn },或使用 { shape: rect|oval, widthIn, heightIn }。
airflowTypeenum否系统类型,用于设定风速上限。默认值为 supply。supply | return | exhaust | outside-air

详细介绍

@openmep/mcp

一个 MCP 服务,为任何 Agent 提供 OpenMEP 确定性的 HVAC 风管尺寸计算。 无需编辑器、CAD 宿主、账户或网络访问:Agent 描述风管,计算引擎确定尺寸。

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

Claude Code:claude mcp add openmep -- npx -y -p @openmep/mcp openmep-mcp。 需要 Node.js 24+。传输方式:stdio。

工具

工具输入返回内容
size_ductcfm、可选的 role(main/branch/runout)、airflowType(supply/return/exhaust/outside-air)、existing 部分({diameterIn} 或 {shape: rect|oval, widthIn, heightIn})推荐的标准圆形风管直径、风速、摩擦率;对于现有截面,返回其等效圆形直径以及 ok/undersized/oversized
size_duct_networkitems:包含 requiredCfm 的末端、管段(可选包含 existing 和 lengthFt)、管件(可选包含 equivalentLengthFt)、设备,通过 connectedItemRefs 连接;可选的 fan(externalStaticInWg、componentLossesInWg)每个负载管段的 CFM、角色、建议尺寸和等级;提供 fan 时,返回 Manual D design(可用静压、总等效长度、摩擦率、控制路径);以及缺少 CFM、末端未连接、悬空引用、系统混杂、管路尺寸不足或过大、摩擦率超出 0.06–0.18 等问题

这两个工具均为只读且具备幂等性。无效输入会返回指出字段的工具错误(NetworkInputError [invalid-item]: items[2].requiredCfm: ...),以便模型修正。

在全新的 Claude Code 会话中,仅使用此服务即可运行的示例提示词:

我有一台炉子,为一条送风主管供风,主管分支连接两条支管:卧室 1 需要 120 CFM,卧室 2 需要 90 CFM,客厅从主管末端供风,风量为 200 CFM。所有管道均绘制为 6 英寸圆形。大厅有一个回风格栅,风量为 410 CFM,接在一条 10 英寸支管上。有没有尺寸不足的管道?

Agent 会通过一次 size_duct_network 调用构建网络,并报告支管尺寸分别为 7、6 和 8 英寸,主管为 11 英寸,回风支管的 10 英寸尺寸略显不足。

工程依据与限制

采用 0.08 in. w.g./100 ft 的等摩擦率;如果提供 fan 和长度,则采用根据风机可用静压推导的 Manual D 摩擦率。根据系统类型限制风速,并向上取整至标准圆形直径;有关公式、来源和未涵盖的内容(管件损失、静压汇总、风机选择),请参见 @openmep/hvac-domain。风量是设计输入,服务不会估算风量。请将结果视为需由工程师审核的初步尺寸计算。

此服务使用官方 MCP TypeScript SDK,并支持 initialize 握手协议修订版(截至 2025-11-25),当前客户端均支持这些修订版。

库

import { createOpenMepServer } from "@openmep/mcp";
await createOpenMepServer().connect(transport); // any MCP server transport

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。