Performs deterministic HVAC duct sizing and grades existing ductwork using Manual D friction rates.
Also known as samarmstrong/openmep, openmep, @openmep/mcp
- Stars
- 0
- Tools
- 2
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Oct 7, 2026
- License
- MIT
What is OpenMEP MCP?
OpenMEP performs deterministic HVAC duct sizing and grades existing ductwork using Manual D friction rates. It exposes 2 tools, such as size_duct, size_duct_network.
Summary generated from the project's README
About OpenMEP MCP server
HVAC engineers and developers can perform deterministic duct sizing and grading directly through an AI agent. By describing duct dimensions, airflow requirements, and system layouts, users can receive recommendations for standard round diameters, velocities, and friction rates based on Manual D standards. The server operates locally via stdio using Node.js 24+ and requires no CAD host, external accounts, or network access.
Users interact with two primary tools: size_duct for individual segments and size_duct_network for complex systems. The network tool processes terminals, segments, fittings, and equipment to identify issues like disconnected terminals, missing CFM, or friction rates falling outside the 0.06–0.18 range. When a fan is included, the engine calculates the Manual D design, including available static pressure and total effective length. This tool is intended for preliminary sizing and should be reviewed by a professional engineer.
What you can do with it
- 1Grade existing ductworkCheck if current duct diameters are sufficient for required airflow by providing existing dimensions.
- 2Analyze entire HVAC networksEvaluate a complete system of terminals and segments to find undersized runs or disconnected components.
- 3Calculate fan design parametersDetermine the total effective length and friction rate when fan static pressure and component losses are provided.
Written from the project's README. Every use case is checked against a quote from it.
How to install OpenMEP MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall OpenMEP MCP in Claude Code
$ claude mcp add openmep -- npx -y @openmep/mcpInstall OpenMEP MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"openmep": {
"command": "npx",
"args": [
"-y",
"@openmep/mcp"
]
}
}
}Install OpenMEP MCP in VS Code
.vscode/mcp.json
{
"servers": {
"openmep": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@openmep/mcp"
]
}
}
}Install OpenMEP MCP in VS Code CLI
$ code --add-mcp '{"name":"openmep","type":"stdio","command":"npx","args":["-y","@openmep/mcp"]}'Install OpenMEP MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"openmep": {
"command": "npx",
"args": [
"-y",
"@openmep/mcp"
]
}
}
}Install OpenMEP MCP in Codex
$ codex mcp add openmep -- npx -y @openmep/mcpInstall OpenMEP MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.openmep] command = "npx" args = ["-y", "@openmep/mcp"]
Install OpenMEP MCP in Gemini CLI
$ gemini mcp add -s user openmep npx -- -y @openmep/mcpInstall OpenMEP MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"openmep": {
"command": "npx",
"args": [
"-y",
"@openmep/mcp"
]
}
}
}OpenMEP MCP tools 2
Detected from the READMEsize_ductsize_duct_network
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablesamarmstrong/openmep is public and reachablegithub.com/samarmstrong/openmep ↗Pass
- Package names this repository as its source@openmep/mcp names samarmstrong/openmep as sourcenpmjs.com/package/@openmep/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-07github.com/samarmstrong/openmep ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @openmep/mcpPass
- No critical advisory in the package or its dependencies100 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@openmep/mcp
An MCP server that gives any agent OpenMEP's deterministic HVAC duct sizing. No editor, CAD host, account, or network access: the agent describes the ducts, the engine sizes them.
{
"mcpServers": {
"openmep": { "command": "npx", "args": ["-y", "-p", "@openmep/mcp", "openmep-mcp"] }
}
}
Claude Code: claude mcp add openmep -- npx -y -p @openmep/mcp openmep-mcp.
Requires Node.js 24+. Transport: stdio.
Tools
| Tool | Input | Returns |
|---|---|---|
size_duct |
cfm, optional role (main/branch/runout), airflowType (supply/return/exhaust/outside-air), existing section ({diameterIn} or {shape: rect|oval, widthIn, heightIn}) |
Recommended standard round diameter, velocity, friction; for an existing section its circular equivalent and ok/undersized/oversized |
size_duct_network |
items: terminals with requiredCfm, segments (optionally with existing and lengthFt), fittings (optionally equivalentLengthFt), equipment, linked by connectedItemRefs; optional fan (externalStaticInWg, componentLossesInWg) |
Every loaded segment's CFM, role, recommendation, and grade; with fan, the Manual D design (available static, total effective length, friction rate, governing paths); findings for missing CFM, disconnected terminals, dangling references, mixed systems, undersized and oversized runs, friction rate outside 0.06–0.18 |
Both tools are read-only and idempotent. Invalid input comes back as a tool
error naming the field (NetworkInputError [invalid-item]: items[2].requiredCfm: ...)
so the model can correct it.
Example prompt that works in a fresh Claude Code session with only this server:
I have a furnace feeding a supply trunk that tees into two runouts: bedroom 1 needs 120 CFM, bedroom 2 needs 90 CFM, and the living room is fed off the trunk end at 200 CFM. All drawn as 6 inch round. One return grille in the hall at 410 CFM on a 10 inch drop. Is anything undersized?
The agent builds the network in one size_duct_network call and reports 7, 6,
and 8 in runouts, an 11 in trunk, and a return drop just under size at 10 in.
Engineering basis and limits
Equal friction at 0.08 in. w.g./100 ft, or at the Manual D rate derived from the blower's
available static pressure when fan and lengths are given, with role-based velocity caps per system,
rounded up to standard round diameters; see
@openmep/hvac-domain for the formula,
sources, and what is excluded (fitting losses, static pressure summation, fan
selection). Airflow is a design input the server never estimates. Treat results
as preliminary sizing for an engineer to review.
The server uses the official MCP TypeScript SDK and speaks the
initialize-handshake protocol revisions (through 2025-11-25), which current
clients support.
Library
import { createOpenMepServer } from "@openmep/mcp";
await createOpenMepServer().connect(transport); // any MCP server transport
OpenMEP MCP questions
How do I add OpenMEP MCP to Claude Code?
Run claude mcp add openmep -- npx -y @openmep/mcp in your terminal. Add --scope user to make it available in every project.
How do I add OpenMEP MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does OpenMEP MCP provide?
It exposes 2 tools, including size_duct, size_duct_network.
What engineering basis does the server use for sizing?
It uses equal friction at 0.08 in. w.g./100 ft or the Manual D rate derived from the blower's available static pressure.
Can the server estimate airflow?
No, airflow is a design input that the server does not estimate.
What happens if I provide invalid input?
The tool returns an error naming the specific invalid field so the model can correct it.