Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

fix: handle hosted window levels

sammohammad578aed846f87763
diff --git a/Hermes.json b/Hermes.json
new file mode 100644
index 0000000..88e2aec
--- /dev/null
+++ b/Hermes.json
@@ -0,0 +1,184 @@
+{
+ "mcpServers": {
+ "aec-model-bridge": {
+ "command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
+ "args": [
+ "-m",
+ "revit_mcp_server.mcp_server"
+ ],
+ "env": {
+ "MCP_REVIT_MODE": "bridge",
+ "MCP_REVIT_BRIDGE_URL": "http://127.0.0.1:3000",
+ "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
+ "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
+ },
+ "tools": {
+ "include": [
+ "aec_map_workspace_path",
+ "aec_register_mapping",
+ "aec_translate_id",
+ "approve_plan",
+ "execute_plan",
+ "list_pending_plans",
+ "plan_actions",
+ "reject_plan",
+ "rollback_plan",
+ "ifc_get_bounding_box",
+ "ifc_get_metadata",
+ "ifc_get_properties",
+ "ifc_get_spatial_structure",
+ "ifc_health",
+ "ifc_query_elements",
+ "ifc_validate",
+ "job_cancel",
+ "job_status",
+ "familytype_mapper_audit_families",
+ "familytype_mapper_list_type_mappings",
+ "model_inspector_ask",
+ "model_inspector_inspect_selection",
+ "model_inspector_list_groups",
+ "model_inspector_list_saved_queries",
+ "model_inspector_run_saved_query",
+ "model_inspector_save_query",
+ "model_inspector_summarize_model",
+ "module_list_commands",
+ "parameter_manager_diff_params",
+ "parameter_manager_export_params_csv",
+ "parameter_manager_filter_params",
+ "parameter_manager_import_params_csv",
+ "parameter_manager_plan_set_params",
+ "qaqc_checker_list_issues",
+ "qaqc_checker_list_rules",
+ "qaqc_checker_resolve_issue",
+ "qaqc_checker_run_check",
+ "recipe_runner_get_run_status",
+ "recipe_runner_list_recipes",
+ "recipe_runner_list_runs",
+ "recipe_runner_run_recipe",
+ "report_generator_export_excel",
+ "report_generator_export_sqlite_summary",
+ "selection_tools_group_convert_to_detail",
+ "selection_tools_group_rename",
+ "selection_tools_group_ungroup",
+ "selection_tools_list_saved_selections",
+ "selection_tools_restore_selection",
+ "selection_tools_save_selection",
+ "selection_tools_select_by_query",
+ "selection_tools_set_selection",
+ "revit_apply_view_template",
+ "revit_batch_create_sheets_from_csv",
+ "revit_batch_set_parameters",
+ "revit_batch_set_parameters_by_filter",
+ "revit_calculate_material_quantities",
+ "revit_change_element_type",
+ "revit_check_clashes",
+ "revit_close_document",
+ "revit_convert_to_group",
+ "revit_copy_element",
+ "revit_create_3d_view",
+ "revit_create_beam",
+ "revit_create_column",
+ "revit_create_conduit",
+ "revit_create_dimension",
+ "revit_create_duct",
+ "revit_create_floor",
+ "revit_create_floor_plan_view",
+ "revit_create_foundation",
+ "revit_create_grid",
+ "revit_create_group",
+ "revit_create_level",
+ "revit_create_material",
+ "revit_create_new_document",
+ "revit_create_pipe",
+ "revit_create_project_parameter",
+ "revit_create_roof",
+ "revit_create_room",
+ "revit_create_schedule",
+ "revit_create_section_view",
+ "revit_create_shared_parameter",
+ "revit_create_sheet",
+ "revit_create_tag",
+ "revit_create_text_note",
+ "revit_create_wall",
+ "revit_delete_element",
+ "revit_delete_sheet",
+ "revit_duplicate_sheet",
+ "revit_edit_family",
+ "revit_execute_python",
+ "revit_export_dwg",
+ "revit_export_ifc",
+ "revit_export_image",
+ "revit_export_navisworks",
+ "revit_extract_snapshot",
+ "revit_get_categories",
+ "revit_get_design_options",
+ "revit_get_document_info",
+ "revit_get_element_bounding_box",
+ "revit_get_element_geometry",
+ "revit_get_element_parameters",
+ "revit_get_element_type",
+ "revit_get_elements_by_type",
+ "revit_get_group_members",
+ "revit_get_link_instances",
+ "revit_get_parameter_value",
+ "revit_get_phase_filters",
+ "revit_get_phases",
+ "revit_get_revision_sequences",
+ "revit_get_rvt_links",
+ "revit_get_schedule_data",
+ "revit_get_selection",
+ "revit_get_sheet_info",
+ "revit_get_snapshot_delta",
+ "revit_get_type_parameters",
+ "revit_get_view_templates",
+ "revit_get_warnings",
+ "revit_get_worksets",
+ "revit_health",
+ "revit_invoke_method",
+ "revit_list_elements",
+ "revit_list_families",
+ "revit_list_levels",
+ "revit_list_project_parameters",
+ "revit_list_shared_parameters",
+ "revit_list_sheets",
+ "revit_list_titleblocks",
+ "revit_list_views",
+ "revit_mirror_element",
+ "revit_move_element",
+ "revit_pin_element",
+ "revit_place_door",
+ "revit_place_family_instance",
+ "revit_place_viewport_on_sheet",
+ "revit_place_window",
+ "revit_populate_titleblock",
+ "revit_reflect_get",
+ "revit_reflect_set",
+ "revit_relinquish_all",
+ "revit_render_3d",
+ "revit_renumber_sheets",
+ "revit_replace_family_type",
+ "revit_rotate_element",
+ "revit_save_document",
+ "revit_set_element_material",
+ "revit_set_parameter_value",
+ "revit_set_selection",
+ "revit_set_type_parameter",
+ "revit_sync_to_central",
+ "revit_tag_all_in_view",
+ "revit_ungroup",
+ "revit_unpin_element",
+ "graph_add_relation",
+ "graph_audit_clashes",
+ "graph_audit_disconnected",
+ "graph_audit_structural_loads",
+ "graph_compile",
+ "graph_health",
+ "graph_query_relations",
+ "exporter_db_health",
+ "exporter_graph_to_sqlite",
+ "exporter_to_sqlite"
+ ]
+ }
+ }
+ }
+}
diff --git a/README.md b/README.md
index 2fd7008..eef8144 100644
--- a/README.md
+++ b/README.md
@@ -176,6 +176,8 @@ that the server may access:
```
VS Code users can start from [`.vscode/mcp.json`](.vscode/mcp.json).
+Hermes Desktop users can start from [`Hermes.json`](Hermes.json); replace the
+placeholder Python path with the path to your local virtual environment.
Clients that support MCP Bundles can install the `.mcpb` file from the
[latest release](https://github.com/Sam-AEC/aec-model-bridge/releases/latest).
diff --git a/packages/revit-bridge-addin/src/Bridge/BridgeCommandFactory.cs b/packages/revit-bridge-addin/src/Bridge/BridgeCommandFactory.cs
index 68adb94..9039e3d 100644
--- a/packages/revit-bridge-addin/src/Bridge/BridgeCommandFactory.cs
+++ b/packages/revit-bridge-addin/src/Bridge/BridgeCommandFactory.cs
@@ -811,7 +811,9 @@ public static class BridgeCommandFactory
doc.Regenerate();
}
- var window = doc.Create.NewFamilyInstance(location, familySymbol, wall, Autodesk.Revit.DB.Structure.StructuralType.NonStructural);
+ var level = GetPlacementLevel(doc, wall, location);
+ var window = doc.Create.NewFamilyInstance(location, familySymbol, wall, level, Autodesk.Revit.DB.Structure.StructuralType.NonStructural);
+ SetWindowSillHeight(window, location, level);
trans.Commit();
@@ -820,7 +822,9 @@ public static class BridgeCommandFactory
window_id = window.Id.Value,
family = familyName,
type = typeName,
- wall_id = wallId
+ wall_id = wallId,
+ level = level.Name,
+ sill_height = location.Z - level.Elevation
};
}
}
@@ -1003,6 +1007,35 @@ public static class BridgeCommandFactory
return level;
}
+ private static Level GetPlacementLevel(Document doc, Wall wall, XYZ location)
+ {
+ if (wall.LevelId != ElementId.InvalidElementId)
+ {
+ var wallLevel = doc.GetElement(wall.LevelId) as Level;
+ if (wallLevel != null)
+ return wallLevel;
+ }
+
+ var level = new FilteredElementCollector(doc)
+ .OfClass(typeof(Level))
+ .Cast<Level>()
+ .OrderBy(l => Math.Abs(l.Elevation - location.Z))
+ .FirstOrDefault();
+
+ if (level == null)
+ throw new InvalidOperationException("No levels found for hosted placement");
+
+ return level;
+ }
+
+ private static void SetWindowSillHeight(FamilyInstance window, XYZ location, Level level)
+ {
+ var sillHeight = location.Z - level.Elevation;
+ var sillParam = window.get_Parameter(BuiltInParameter.INSTANCE_SILL_HEIGHT_PARAM);
+ if (sillParam != null && !sillParam.IsReadOnly)
+ sillParam.Set(sillHeight);
+ }
+
private static WallType GetWallTypeByName(Document doc, string name)
{
var wallType = new FilteredElementCollector(doc)