create_ducts
Create and batch generate ducts in Revit with automatic unit conversion, type matching, and error handling for HVAC system design.
Instructions
在Revit中创建风管，支持批量创建，遵循JSON-RPC 2.0规范。 mcp_tool使用时params不要有任何注释信息
特性:
支持批量创建多个风管
自动处理单位转换（毫米转英尺）
自动匹配风管类型和系统类型
支持指定风管尺寸
完善的错误处理机制
参数: ctx (Context): FastMCP上下文对象 method (str): JSON-RPC方法名，默认为"CreateDucts" params (List[Dict]): 风管参数列表，每个字典包含: - ductTypeName (str): 风管类型名称 - systemTypeName (str): 风管系统类型名称 - startX (float): 起点X坐标（毫米） - startY (float): 起点Y坐标（毫米） - startZ (float): 起点Z坐标（毫米） - endX (float): 终点X坐标（毫米） - endY (float): 终点Y坐标（毫米） - endZ (float): 终点Z坐标（毫米） - width (float): 风管宽度（毫米） - height (float): 风管高度（毫米）
返回: dict: JSON-RPC 2.0格式的响应，结构为: 成功时: { "jsonrpc": "2.0", "result": [ { "elementId": "元素ID", "name": "名称", "familyName": "族名称" }, ... ], "id": request_id } 失败时: { "jsonrpc": "2.0", "error": { "code": int, "message": str, "data": any }, "id": request_id }
示例: response = create_ducts(ctx, params=[ { "ductTypeName": "默认", "systemTypeName": "送风", "startX": 0, "startY": 0, "startZ": 3000, "endX": 5000, "endY": 0, "endZ": 3000, "width": 300, "height": 200 }, { "ductTypeName": "矩形风管", "systemTypeName": "送风", "startX": 5000, "startY": 0, "startZ": 3000, "endX": 5000, "endY": 5000, "endZ": 3000, "width": 300, "height": 200 } ])
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| method | No | CreateDucts | |
| params | No |
Implementation Reference
- xml_revit_mcp/server.py:46-48 (registration)Definition of MEP_TOOLS list including create_ducts for tool registration
MEP_TOOLS = [ create_ducts, create_pipes, create_cable_trays ] - xml_revit_mcp/server.py:140-142 (registration)Registration loop for MEP tools including create_ducts using server.tool() decorator
# 注册MEP工具 for tool in MEP_TOOLS: server.tool()(tool) - xml_revit_mcp/server.py:16-16 (registration)Import of tools including create_ducts from .tools module
from .tools import * - xml_revit_mcp/prompts.py:36-36 (helper)Prompt mentioning usage of create_ducts tool
- 使用create_ducts()创建风管