Atlas / MCP servers / ajhcs / Cameo Bridge

Cameo BridgeCAUTION

Name: Cameo Bridge
Author: ajhcs

mcp/ajhcs/cameo-bridge

MCP server by ajhcs · cameo · catia magic · claude · Audited 2026-10-08

MCP server bridging AI assistants to CATIA Magic / Cameo Systems Modeler for SysML/UML model creation, querying, and manipulation

Verdict

CAUTION

Grade

Trust score

87 /100

Exposed tools

162 97r · 56w · 9d

Transport

stdio

License

MIT

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

An MCP (Model Context Protocol) server that connects AI coding assistants to CATIA Magic / Cameo Systems Modeler -- the industry-standard MBSE tool for SysML and UML modeling.

This lets Claude Code (or any MCP-compatible client) query, create, modify, inspect, validate, and visualize SysML/UML models inside a running Cameo instance through 162 tools covering capability negotiation, methodology-aware OOSEM workflows, semantic validation, state-machine semantics, elements, relationships, native matrices and tables, Relation Maps, reports, requirements import/export, validation suites, Teamwork/DataHub probes, diagrams, reusable verification, specifications, and guarded macro execution.

Claude Code    Python MCP Server    Java Plugin (Cameo JVM)

Why This Exists

MBSE tools like Cameo are powerful but manual. With this bridge, an AI assistant can:

Build models from requirements -- "Create a state machine for ATM operations with idle, active, and maintenance states"
Query and navigate models -- "Show me all blocks with the > stereotype"
Generate diagrams -- Create sequence diagrams, BDDs, IBDs, state machines, and populate them with elements
Export diagram images -- Get PNG snapshots of any diagram as base64
Run Groovy scripts -- Escape hatch for anything the structured tools don't cover
Inspect and modify specifications -- Read/write any UML property, tagged value, or constraint

How Is This Different?

Read from source at commit 9e711523901bOBSERVED · 2026-10-08

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code

claude mcp add cameo-mcp-server -- uvx cameo-mcp-server

claude-desktop

{
  "mcpServers": {
    "cameo-mcp-server": {
      "command": "uvx",
      "args": [
        "cameo-mcp-server"
      ]
    }
  }
}

Exposed tools (162)

97 read · 56 write · 9 destructive. Blast radius: 9 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

Tool	Risk	Description
`cameo_add_diagram_paths`	write	Add relationship lines (paths) to a diagram.
`cameo_add_to_diagram`	write	Add a model element to a diagram canvas.
`cameo_analyze_variants_preview`	read	Preview variant/product-line analysis without writes.
`cameo_apply_criteria_template`	write	Apply a criteria template after UI-diff verification.
`cameo_apply_profile`	write	Apply a profile to a model/package so its stereotypes become usable.
`cameo_apply_proofing_patch_plan`	write	Apply a previously generated proofing patch plan to the live model.
`cameo_apply_requirements_import`	write	Apply or dry-run a reviewed requirements import request.
`cameo_apply_stereotype`	write	Apply a stereotype to an element.
`cameo_assemble_ppt_pdf`	read	Plan or assemble a PPT/PDF package from methodology-required diagrams.
`cameo_auto_layout`	write	Apply automatic layout to a diagram.
`cameo_build_criteria_expression`	read	Build a bridge-owned criteria expression preview.
`cameo_build_cross_diagram_remediation_plan`	read	Build a previewable remediation plan from existing validation payloads.
`cameo_capture_criteria_template_from_diff`	read	Capture a native criteria template from before/after snapshot evidence.
`cameo_collapse_relation_map`	read	Try to collapse native Relation Map nodes and report before/after counts.
`cameo_compare_expected_artifact_list`	read	Compare discovered/current artifacts against an expected methodology artifact list.
`cameo_compare_relation_maps`	read	Compare two Relation Maps, usually a UI-created map and a bridge-created map.
`cameo_configure_relation_map`	write	Update native graph settings for an existing Relation Map.
`cameo_create_diagram`	write	Create a new SysML or UML diagram.
`cameo_create_element`	write	Create a new model element.
`cameo_create_generic_table`	write	Create and configure a native Generic Table artifact.
`cameo_create_matrix`	write	Create a supported native matrix artifact.
`cameo_create_relation_map`	write	Create and configure a native Relation Map artifact.
`cameo_create_relationship`	write	Create a relationship between two elements.
`cameo_create_snapshot`	write	Capture an in-memory inspection snapshot for before/after UI diffs.
`cameo_delete_element`	destructive	Delete a model element.
`cameo_delete_shapes`	destructive	Delete presentation elements (shapes/paths) from a diagram canvas.
`cameo_delete_snapshot`	destructive	Delete an in-memory snapshot without changing the CATIA model.
`cameo_detect_cross_diagram_inconsistencies`	read	Detect cross-diagram inconsistencies and return a previewable remediation plan.
`cameo_diff_snapshots`	read	Diff two snapshots to reveal what CATIA Magic UI actions changed.
`cameo_dump_diagram_properties`	read	Dump diagram settings and paged presentation property summaries.
`cameo_dump_presentation_properties`	read	Dump full properties for one selected diagram presentation element.
`cameo_dump_relation_map_raw_settings`	read	Dump native Relation Map settings for UI-diff investigation.
`cameo_execute_macro`	write	Execute a Groovy script inside CATIA Magic
`cameo_execute_methodology_recipe`	write	Execute a bounded OOSEM methodology recipe through structured bridge calls.
`cameo_execute_probe`	write	Execute a controlled discovery probe.
`cameo_expand_relation_map`	read	Try to expand native Relation Map nodes and report before/after counts.
`cameo_export_profile_summary`	read	Export a summary of profile and stereotype elements in the open project.
`cameo_export_required_diagrams`	write	Plan or execute export of methodology-required diagrams.
`cameo_export_requirements`	write	Export requirement-like elements through the import/export route.
`cameo_export_requirements_preview`	read	Preview requirement export without mutating the model.
`cameo_export_variant_configuration`	read	Preview exporting a bridge-owned variant configuration evidence payload.
`cameo_generate_report`	read	Generate a Report Wizard artifact from a real native template.
`cameo_generate_report_preview`	read	Preview a guarded Report Wizard generation request.
`cameo_generate_review_packet`	read	Generate a compact methodology review packet without mutating the model.
`cameo_get_active_diagram`	read	Get the currently active CATIA Magic diagram as a small payload.
`cameo_get_capabilities`	read	Get machine-readable plugin capabilities and version-lockstep metadata.
`cameo_get_containment_tree`	read	Browse the containment tree structure.
`cameo_get_criteria_capabilities`	read	Probe generic criteria expression support.
`cameo_get_datahub_capabilities`	read	Probe DataHub/DOORS integration availability.
`cameo_get_diagram_image`	read	Export a diagram as a base64-encoded PNG image.
`cameo_get_element`	read	Get full details of a model element.
`cameo_get_extension_capabilities`	read	Probe safety/cyber extension availability.
`cameo_get_generic_table`	read	Get one native Generic Table with row, column, and cell data.
`cameo_get_import_export_capabilities`	write	Probe bridge-owned CSV/JSON and native ReqIF import/export support.
`cameo_get_matrix`	read	Read one supported native matrix with populated cell data.
`cameo_get_methodology_guidance`	read	Explain what artifact work is missing next for a methodology pack.
`cameo_get_methodology_pack`	read	Get one methodology pack definition.
`cameo_get_profile_capabilities`	read	Probe profile/DSL authoring support.
`cameo_get_project`	read	Get current project info: name, file path, and primary model ID.
`cameo_get_relation_map`	read	Get one native Relation Map with persisted graph settings.
`cameo_get_relationships`	read	Get relationships for an element.
`cameo_get_report_capabilities`	read	Probe Report Wizard API availability and plugin evidence.
`cameo_get_report_job`	read	Fetch a Report Wizard generation job status.
`cameo_get_requirements_capabilities`	read	Probe Requirements/ReqIF API availability and plugin evidence.
`cameo_get_shape_properties`	read	Read the current property state for a specific diagram shape.
`cameo_get_simulation_capabilities`	read	Probe Simulation Toolkit availability.
`cameo_get_simulation_result`	read	Fetch simulation result status.
`cameo_get_snapshot`	read	Get one in-memory bridge snapshot payload.
`cameo_get_specification`	read	Get the full specification of a model element — all UML properties, stereotype tagged values, and constraint fields.
`cameo_get_state_behaviors`	read	Read the structured entry/do/exit behavior payloads for a state.
`cameo_get_teamwork_capabilities`	read	Probe Teamwork/Magic Collaboration Studio API availability.
`cameo_get_teamwork_history`	read	Read Teamwork history diagnostics when available.
`cameo_get_teamwork_locks`	read	Read Teamwork lock diagnostics when available.
`cameo_get_teamwork_project`	read	Read Teamwork project metadata when native readback is promoted.
`cameo_get_traceability_graph`	read	Build a read-only relationship graph for traceability analysis.
`cameo_get_transition_triggers`	write	Read the structured trigger/event state for a transition.
`cameo_get_typed_diagram_capabilities`	write	Probe typed diagram inspection and write-preview support.
`cameo_get_ui_selection`	read	Get selected browser elements and selected diagram presentation IDs.
`cameo_get_ui_state`	read	Inspect live CATIA Magic UI context.
`cameo_get_validation_capabilities`	read	Probe whether CATIA native validation APIs are available through the bridge.
`cameo_get_validation_result`	write	Fetch a cached CATIA native validation run result by run ID.
`cameo_get_variant_capabilities`	read	Probe native or bridge-owned variant support.
`cameo_import_requirements_preview`	write	Preview requirement import/diff without writes.
`cameo_inspect_typed_diagram`	read	Inspect a diagram through the typed diagram route.
`cameo_install_extension_pattern_preview`	write	Preview installing bridge-owned safety/cyber extension patterns.
`cameo_install_variant_pattern_preview`	write	Preview installing bridge-owned variant stereotypes.
`cameo_list_containment_children`	read	List a compact, paginated slice of the containment tree.
`cameo_list_criteria_templates`	read	List criteria templates for relation maps, matrices, tables, or legends.
`cameo_list_datahub_sources`	read	List DataHub sources when native readback is promoted.
`cameo_list_diagram_shapes`	read	List all shapes and relationship paths currently on a diagram.
`cameo_list_diagram_types`	read	List the validated diagram request tokens accepted by the MCP bridge.
`cameo_list_diagrams`	read	List all diagrams in the current project.
`cameo_list_extension_profiles`	read	List extension-related profiles and stereotypes.
`cameo_list_generic_table_columns`	read	List possible native Generic Table column ids for an element or type.
`cameo_list_generic_tables`	read	List native Generic Table artifacts in the current project.
`cameo_list_matrices`	read	List supported native matrix artifacts in the current project.
`cameo_list_matrix_kinds`	read	List the validated native matrix kinds and example type domains.
`cameo_list_methodology_packs`	read	List built-in methodology packs available in the Phase 2 copilot layer.
`cameo_list_probe_templates`	read	List safe built-in CATIA API discovery probes.
`cameo_list_relation_map_criteria_templates`	read	List built-in Relation Map criteria templates.
`cameo_list_relation_map_presentations`	read	List loaded Relation Map presentation nodes, paths, and legend elements.
`cameo_list_relation_maps`	read	List native Relation Map artifacts in the current project.
`cameo_list_report_templates`	read	List Report Wizard templates when native readback is promoted.
`cameo_list_simulation_configurations`	read	List simulation configurations when native readback is promoted.
`cameo_list_snapshots`	read	List in-memory bridge snapshots available for diffing.
`cameo_list_teamwork_branches`	read	List Teamwork branches when available.
`cameo_list_teamwork_descriptors`	read	List Teamwork descriptors when the native client is authenticated.
`cameo_list_typed_diagrams`	read	List diagrams with type metadata for typed handlers.
`cameo_list_validation_suites`	read	List candidate native validation suites and constraints in the open project.
`cameo_modify_element`	write	Modify an existing element name or documentation.
`cameo_move_shapes`	write	Move and/or resize shapes on a diagram canvas.
`cameo_normalize_compartment_presets`	read	Normalize compartment presets based on the diagram type.
`cameo_parse_criteria_expression`	read	Parse a criteria expression into a diagnostic payload.
`cameo_preview_datahub_sync`	write	Preview DataHub sync without writing to CATIA or external systems.
`cameo_preview_profile_operation`	write	Preview a profile operation such as create-profile, create-stereotype, create-tag, apply-profile, or set-tags.
`cameo_preview_requirements_import`	write	Preview requirements import through the import/export route.
`cameo_preview_teamwork_commit`	write	Preview a Teamwork commit without changing the server project.
`cameo_preview_teamwork_update`	write	Preview a Teamwork update without changing the server project.
`cameo_preview_typed_diagram_operation`	read	Preview a typed diagram operation such as sequence-message, state-transition, parametric-binding, or legend-apply.
`cameo_probe_bridge`	read	Probe common local bridge endpoints and report the preferred health paths.
`cameo_proof_model_text`	read	Proof model text across requirements, comments, states, transitions, and diagram labels.
`cameo_prune_diagram_presentations`	destructive	Delete unwanted diagram presentations using keep/drop rules.
`cameo_prune_path_decorations`	read	Prune child path decorations such as association end-role labels.
`cameo_query_elements`	read	Search for model elements matching filters.
`cameo_refresh_relation_map`	read	Refresh a native Relation Map after model or settings changes.
`cameo_refuse_compliance_claim`	read	Return the bridge refusal contract for unsupported compliance claims.
`cameo_render_relation_map`	read	Render/export a Relation Map image; native refresh is opt-in because it can block CATIA.
`cameo_repair_conveyed_item_labels`	destructive	Force conveyed-item labels and optional label resets on eligible paths.
`cameo_repair_hidden_labels`	read	Auto-show hidden labels using diagram-type-aware native repair defaults.
`cameo_repair_label_positions`	destructive	Reset likely-overlapping path labels to readable default positions.
`cameo_reparent_shapes`	write	Move existing presentation elements under new container shapes.
`cameo_reset_session`	destructive	Force-close any stuck model editing session in CATIA Magic.
`cameo_route_paths`	destructive	Update routing and label reset behavior for existing diagram paths.
`cameo_run_native_validation`	write	Run CATIA native validation for a suite or explicit constraint IDs.
`cameo_run_simulation`	write	Call the guarded simulation run endpoint.
`cameo_run_simulation_preview`	write	Preview a bounded simulation run request.
`cameo_run_validation`	write	Run or preview bounded native Cameo validation.
`cameo_save_project`	write	Save the current project to disk.
`cameo_scan_extensions`	read	Preview a read-only safety/cyber extension model scan.
`cameo_set_allocation_compartment_presentation`	write	Apply a high-level allocation/full-port display preset on one diagram.
`cameo_set_item_flow_label_presentation`	write	Apply a high-level item-flow/information-flow label preset on one diagram.
`cameo_set_relation_map_criteria`	write	Apply Relation Map criteria using templates or raw UI-derived expressions.
`cameo_set_shape_compartments`	write	Apply normalized compartment visibility controls to one diagram shape.
`cameo_set_shape_properties`	write	Set display properties on a specific diagram shape.
`cameo_set_specification`	write	Set properties and/or constraint fields on a model element
`cameo_set_state_behaviors`	write	Set structured entry/do/exit opaque behaviors for a state.
`cameo_set_stereotype_metaclasses`	write	Set the base metaclasses for a stereotype using Cameo
`cameo_set_tagged_values`	write	Set tagged values on a stereotyped element.
`cameo_set_transition_label_presentation`	write	Apply a high-level transition-label display preset on one diagram.
`cameo_set_transition_trigger`	write	Create or replace one transition trigger with explicit semantics.
`cameo_set_usecase_subject`	write	Set or append subject classifiers on a UseCase.
`cameo_status`	read	Check if CATIA Magic is running and the CameoMCPBridge plugin is responsive.
`cameo_terminate_simulation`	destructive	Terminate an active simulation job when execution support is enabled.
`cameo_validate_methodology_package`	read	Validate a package or recipe scope against the methodology definition.
`cameo_validate_methodology_recipe`	write	Run methodology conformance checks for an artifact recipe.
`cameo_verify_activity_flow_semantics`	read	Validate whether one activity diagram behaves like a coherent workflow.
`cameo_verify_cross_diagram_traceability`	read	Validate traceability across activity, port, IBD, and requirement views.
`cameo_verify_diagram_visual`	write	Run reusable visual verification checks against one diagram.
`cameo_verify_matrix_consistency`	write	Run quantitative consistency checks against one native requirement matrix.
`cameo_verify_port_boundary_consistency`	read	Validate interface-block flow-property ownership and duplication.
`cameo_verify_relation_map`	read	Verify graph traversal, native settings validity, and rendered count separately.
`cameo_verify_requirement_quality`	read	Validate whether SysML requirements contain real requirement content.

Trust audit

CAUTIONgrade B · trust 87/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	WARN
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	WARN
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (1 observation(s))
Network: declared (5 observation(s))
Shell: none-observed
Dependencies: pinned
Secrets in source: none-found

Findings (16)

MEDIUMInventory / provenance · inv.binary · CWE-1104

plugin/gradle/wrapper/gradle-wrapper.jar

gradle-wrapper.jar

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59

cameo_delete_element, cameo_delete_shapes, cameo_delete_snapshot, cameo_prune_diagram_presentations, cameo_repair_conveyed_item_labels, cameo_repair_label_positions, cameo_reset_session, cameo_route_p

Why it matters. 9 tool(s) can delete or overwrite

Fix. prefer a read-only mode or scoped tokens; the page states the blast radius