Cameo MCP Bridge

Cameo MCP大桥

一 MCP（模型上下文协议） 将AI编码助手连接到的服务器 CATIA Magic/Cameo系统建模器 --用于SysML和UML建模的行业标准MBSE工具。

这让Claude Code（或任何兼容MCP的客户端） 查询、创建、修改、检查、验证和可视化 通过162个工具在正在运行的Cameo实例中建立SysML/UML模型，这些工具涵盖了能力协商、方法感知OOSEM工作流、语义验证、状态机语义、元素、关系、本机矩阵和表、关系图、报告、需求导入/导出、验证套件、团队合作/DataHub探测、图表、可重用验证、规范和受保护的宏执行。

Claude Code    Python MCP Server    Java Plugin (Cameo JVM)

为什么存在

像Cameo这样的MBSE工具功能强大，但需要手动操作。有了这座桥，人工智能助手可以：

• 根据需求构建模型 --创建具有空闲、活动和维护状态的ATM操作状态机
• 查询和导航模型 --“向我展示所有带有 > 刻板印象”
• 生成图表 --创建序列图、BDD、IBD、状态机，并用元素填充它们
• 导出图表图像 --以base64格式获取任何图表的PNG快照
• 运行Groovy脚本 --结构化工具无法覆盖的任何东西的逃生口
• 检查和修改规范 --读/写任何UML属性、标记值或约束

这有什么不同？

这是唯一一个直接与正在运行的Cameo实例集成的开源MCP服务器，可以完全访问SysML v1模型和完整的Cameo API表面。

建筑

+-------------------+         +---------------------+         +---------------------------+
|                   |  stdio  |                     |  HTTP   |                           |
|  Claude Code /    |-------->|  Python MCP Server  |-------->|  Java Plugin              |
|  Any MCP Client   |/plugins/com.claude.cameo.bridge/

3.安装Python服务器：

cd mcp-server
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e .

在Windows shell上，使用 .venv\\Scripts\\activate 相反。

4.向您的MCP客户注册：

克劳德代码：

claude mcp add cameo-bridge --scope user -- /absolute/path/to/mcp-server/.venv/bin/python -m cameo_mcp.server

在Windows上，解释器路径通常为 .venv\\Scripts\\python.exe.

对于其他MCP客户端，使用venv解释器和命令配置stdio传输 -m cameo_mcp.server.

5.重新启动CATIA Magic，打开一个项目，然后验证：

> Check cameo status

如果新添加的MCP工具在更新后返回HTTP 404，Python服务器 Java插件不同步。重建/重新部署插件，然后重新启动 CATIA Magic加载了新的HTTP处理程序。

Python端现在对之前的插件执行功能握手 非状态操作。如果 cameo_status 或 cameo_get_capabilities 报告 compatibility.clientCompatible = false，停止并重新部署匹配的插件 在继续之前。

Python MCP层还为bounded提供了第2阶段的方法论界面 OOSEM工作流程。这些工具构建命名工件配方、工作流指导、， 一致性检查、语义验证和紧凑的审查数据包 低层桥梁。

2.3.5中的新功能

• 用于创建/配置、标准模板、表示检查、图形回读、渲染/验证、快照差异和显式刷新的本机关系图工具。
• 用于活动图、浏览器选择、选定符号和原始图/演示属性转储的实时UI自检工具。
• 探测原生验证、报告向导、需求导入/导出、模拟、团队合作、DataHub、变体、配置文件、类型图和安全/网络扩展的第一路由系列。
• JSON/CSV要求导入/导出，具有模拟运行默认值、显式写门、作用域导出和测试。
• 使用模板发现和输出文件收据生成本机报告向导。
• 更安全的长时间运行的CATIA操作：Python端的请求超时和Java端的序列化写入会话。

配置

Java插件从系统属性读取端口 cameo.mcp.port （默认值 18740).要更改它，请添加到您的Cameo *.vmoptions 文件：

-Dcameo.mcp.port=18741

并设置 CAMEO_BRIDGE_PORT=18741 在启动Claude Code之前，请先在您的环境中。

对于本地健康检查，插件现在对两者都有响应 /api/v1/status 以及遗产 /status 别名。同样适用于 /api/v1/capabilities 和 /capabilities.

工具参考

项目、会话和UI（9个工具）

方法包（6个工具）

元素（8个工具）

支持的元素类型： 包、配置文件、原型、类、块、属性、流属性、端口、接口、活动、用例、参与者、状态机、状态、伪状态、初始化状态、需求、接口块、约束块、值类型、数据类型、信号、枚举、组件、注释、约束、CallBehaviorAction、OpaqueAction、ActivityPartition、InitialNode、ActivityFinalNode、FlowFinalNode、DecisionNode、MergeNode、ForkNode、JoinNode、InputPin、OutputPin、操作

SysML别名，例如 Block, Requirement, ConstraintBlock, InterfaceBlock, ValueType，以及 FlowProperty 依赖于SysML配置文件的可用性。该桥现在将缺少所需的原型视为错误，而不是默默地生成简单的UML元素。 Pseudostate 当前映射到MVP中的初始伪状态。

对于大型项目，首选 cameo_list_containment_children 结束 cameo_get_containment_tree递归树端点仍然可以兼容，但它可以在真实模型上产生非常大的响应。

刻板印象和标签价值观（3个工具）

如果您通过MCP创建自定义配置文件，典型的顺序是：

1. 创建 Profile
2. 创建 Stereotype 内部元素，可选配 metaclasses=[...]
3. 呼叫 cameo_apply_profile 关于目标模型/包
4. 将新的原型应用于模型元素

关系（2个工具）

支持的关系类型： 关联、定向关联、组合、泛化、依赖、控制流、对象流、转换、连接器、信息流、项目流、分配、满足、推导、精炼、跟踪、验证、包含、扩展

Connector 支持嵌套端口 partWithPort 所有权。 InformationFlow 和 ItemFlow 支持结构化 realizingConnector, conveyed，以及SysML itemProperty IBD项目流工作流的有效载荷数据。当您将IBD上下文元素传递为 ownerId，桥梁解决了实际问题 InformationFlow/ItemFlow 因为Cameo不允许这些关系直接由一个区块拥有。

矩阵和通用表（8个工具）

支持的矩阵类型： refine, derive, satisfy, allocation, dependency

这些工具针对Cameo的原生矩阵工件：

• refine -> Refine Requirement Matrix
• derive -> Derive Requirement Matrix
• satisfy -> Satisfy Requirement Matrix
• allocation -> SysML Allocation Matrix
• dependency -> Dependency Matrix

此矩阵族与图表形状/路径API是分开的。它管理本机矩阵工件，并直接返回行/列/单元格数据。

cameo_create_matrix 也接受可选 row_types 和 column_types 列表，以便在底层矩阵类型支持时，可以将本地矩阵工件约束到特定域。使用 cameo_list_matrix_kinds 查看经过验证的种类别名和经过现场验证的示例类型域。

关系图、快照和探针（22个工具）

关系图本地刷新可以在大型地图上阻止CATIA的EDT。桥接器保持对创建/配置/渲染/标准/展开/折叠路径的刷新选择；呼叫 cameo_refresh_relation_map 当您需要原生UI刷新行为时。

高级原生曲面（42个工具）

当可选的CATIA插件、许可证或实时证明缺失时，这些路线系列会故意失败关闭。预览/拒绝有效载荷是公共合同的一部分，而不是占位符错误。

图表（24种工具）

已验证的图表请求令牌： Class, Package, UseCase, Activity, Sequence, StateMachine, Component, Deployment, CompositeStructure, Object, Communication, InteractionOverview, Timing, Profile, BDD, IBD, Requirement Diagram, Parametric Diagram, RelationMap, Content Diagram

使用 cameo_list_diagram_types 如果你也想要被接受的别名。常见形式，如 InternalBlockDiagram, SysML IBD, ClassDiagram，以及 StateMachineDiagram 自动归一化为已验证的令牌集。

验证（2个工具）

这些验证工具是桥的原生图和矩阵读回的Python侧包装器。它们旨在用于可重复的回归检查、视觉健全性验证和轻量级定量验证，而不会陷入原始宏。

语义验证（4个工具）

这些工具是MBSE审查的语义第一层。他们使用桥读回和轻量级Python启发式方法来捕捉常见的故障模式，在这种模式下，图表看起来合理，但不能作为可审查的模型。

自动修复（2个工具）

这些工具不会改变模型。它们的存在是为了通过返回结构化的预览步骤来弥合验证和安全修复之间的差距，稍后应用流程可能会消耗这些步骤。

打样（2个工具）

校对被有意地限定在高置信度的名称/文本修复范围内。证明报告包括调查结果、指标、章节和预览补丁计划，即使在以下情况下也是如此 auto_apply 关闭。

方法论工作流程（4个工具）

对于PPTX程序集，请从以下位置安装Python依赖项 mcp-server/pyproject.toml 所以 python-pptx 在MCP运行时环境中可用。

状态机语义学（4个工具）

这些工具为MCP层提供了一流的状态语义，而不是强迫代理通过通用规范写入或原始宏回退来近似它们。

规格（3个工具）

宏（1个工具）

宏工具是结构化工具未涵盖的操作的逃生舱口。脚本可以完全访问Cameo OpenAPI project, application, primaryModel，以及 ef （ElementsFactory）预先注入到脚本上下文中。

重要提示： 修改模型的脚本必须管理自己的会话：

import com.nomagic.magicdraw.openapi.uml.SessionManager

SessionManager.getInstance().createSession(project, "My operation")
try {
    // ... modify model ...
    SessionManager.getInstance().closeSession(project)
} catch (Exception e) {
    SessionManager.getInstance().cancelSession(project)
    throw e
}

如果宏在会话中期失败，请使用 cameo_reset_session 为了恢复。

用法示例

创建SysML块

Create a block called "Sensor" in the root model package

AI将：

1. 呼叫 cameo_get_project 查找根模型ID
2. 呼叫 cameo_create_element 类型为“Block”，名称为“Sensor”，根模型ID为父级

构建状态机

Create a state machine for an ATM with states OFF, IDLE, ACTIVE, and MAINTENANCE.
Add an initial pseudostate and transitions: initial -> OFF, OFF -> IDLE on startup,
IDLE -> ACTIVE on card insert, ACTIVE -> IDLE on transaction complete, and any state
-> MAINTENANCE on service request.

查询和修改

Find all requirements in the project and show me their IDs and text

导出图表

Export the "System Overview" diagram as a PNG and save it to my desktop

运行Groovy脚本

Run a macro that lists all profiles loaded in the current project

已知限制

图表布局（主要痛点）

这座桥正确地构建了模型——元素、关系、方向性、刻板印象和结构都表现得很好。主要差距是 图表演示：复杂图表的布局、间距和视觉属性通常需要在Cameo的GUI中手动调整。

cameo_list_diagram_shapes 现在递归地发现嵌套的表示元素，但复杂的嵌套编辑仍然不完整。序列图、复合状态和其他深度嵌套的表示仍然需要手动清理或Groovy回退。这意味着：

解决方法：

• 使用 cameo_execute_macro 使用直接访问嵌套表示元素的Groovy脚本
• 使用 cameo_auto_layout （适用于简单的图表，不太适用于复杂的状态机）
• 对于序列图：模型是正确的，因此在Cameo中手动拖放需要5-10分钟
• 对于状态机：手动加宽形状和切换区域名称可见性

当前方向： 继续扩展嵌套演示文稿元素的结构化编辑，以减少需要宏的工作流。

尚未实施

• 本地ReqIF适用 --网桥拥有的JSON/CSV需求导入/导出经过实时验证；本地ReqIF应用仅在捕获一次性ReqIF往返之前保持预览/拒绝状态
• 可选产品写入 --团队合作、数据中心、模拟、变体和安全/网络扩展系列首先暴露了能力探测和安全预览；写入需要单独的实时证明
• 删除刻板印象 --可以应用但不能删除
• 删除/重命名图表 --可以通过网桥创建和填充图表，但不能删除或重命名
• 元件修复 --无法在包之间移动元素
• 撤销/重做 --会话支持Cameo UI中的撤消，但没有MCP工具来触发它
• 批量操作 --创建N个元素需要N个顺序的API调用
• 模型更改通知 --纯粹的请求/响应；无事件订阅
• 基于文件的图表导出 -- cameo_get_diagram_image 通过连线返回base64；没有直接保存到文件路径的选项（使用 cameo_execute_macro 和 ImageExporter.export(dpe, ImageExporter.PNG, file) 作为解决方法）

API缺口

• 持续时间约束/时间约束 由于Cameo API中复杂的所有权链，通过宏创建是不可靠的(DurationInterval.setMin/setMax 需要 Duration API拒绝的具有特定所有权的实例）；在Cameo的用户界面中手动添加这些
• 大图图像 仍然可以在全分辨率下超过MCP客户端令牌限制；更喜欢 cameo_get_diagram_image(include_image=false) 仅用于元数据读取或使用 max_width / max_height 和 format="jpeg" 在切换到基于宏的文件导出之前
• 直接文件导出 仍然不是一流的；如果您需要网桥将图表直接保存到磁盘，请使用 cameo_execute_macro 和 ImageExporter.export(...)
• 会话恢复边缘案例 --如果宏在交易过程中崩溃， cameo_reset_session 可以自己扔 TransactionAlreadyCommitedException在这种情况下，保存并重新打开项目是最可靠的恢复

兼容性

• 使用CATIA Magic Systems of Systems Architect 2024x进行测试
• 应适用于任何Cameo Systems Modeler 2024x捆绑包（2024x+）
• 需要Groovy脚本引擎（与Cameo捆绑在一起）来执行宏
• Gradle版本需要访问Cameo的 lib/ 编译时依赖关系目录

安全注意事项

这座桥是为 仅供当地开发使用.

• HTTP服务器绑定到 127.0.0.1 （仅限本地主机）--无法从网络访问
• 有 无需认证 在HTTP端点上
• 这 cameo_execute_macro 工具执行 任意Groovy代码 在Cameo JVM内部，可以完全访问文件系统、网络和类加载器
• CORS标头设置为 * （通配符）-理论上，本地浏览器中的任何网页都可以向网桥发出请求

不要 将网桥端口暴露给网络，在共享/多用户计算机上运行它而不需要额外的访问控制，或者在生产环境中使用它而不添加身份验证。

项目结构

cameo-mcp-bridge/
  mcp-server/                          # Python MCP server
    cameo_mcp/
      __init__.py
      client.py                        # HTTP client for the Java plugin
      server.py                        # MCP tool definitions (162 tools)
      verification.py                  # reusable diagram/matrix verification helpers
      methodology/                     # Phase 2 pack registry + recipe runtime
        registry.py
        runtime.py
        service.py
    pyproject.toml
  plugin/                              # Java Cameo plugin
    src/com/claude/cameo/bridge/
      CameoMCPBridgePlugin.java        # Plugin entry point
      HttpBridgeServer.java            # Embedded HTTP server + routing
      handlers/
        ProjectHandler.java            # Project info, save
        ElementQueryHandler.java       # Element search, get, relationships
        ElementMutationHandler.java    # Create, modify, delete elements
        RelationshipHandler.java       # Create relationships
        MatrixHandler.java             # Native matrix artifacts
        GenericTableHandler.java       # Native Generic Tables
        DiagramHandler.java            # Full diagram lifecycle
        RelationMapHandler.java        # Relation Map graph/settings/rendering
        UiStateHandler.java            # Active diagram and selection state
        SnapshotHandler.java           # In-memory evidence snapshots
        ValidationHandler.java         # Native validation suites
        ReportWizardHandler.java       # Report Wizard templates/generation
        ImportExportHandler.java       # Requirements import/export
        CriteriaHandler.java           # Criteria expression helpers
        TeamworkHandler.java           # Teamwork read-only probes
        DataHubHandler.java            # DataHub capability/source probes
        SimulationHandler.java         # Simulation preview/run facade
        ExtensionProbeHandler.java     # Safety/cyber extension probes
        ContainmentTreeHandler.java    # Containment tree browsing
        SpecificationHandler.java      # Specification read/write
        MacroHandler.java              # Groovy script execution
      util/
        EdtDispatcher.java             # EDT dispatch with session management
        ElementSerializer.java         # Element to JSON serialization
        JsonHelper.java                # JSON parsing utilities
    plugin.xml                         # Cameo plugin descriptor
    build.gradle                       # Gradle build config
  install.sh                           # One-step installer
  LICENSE
  README.md

发展

构建插件

cd plugin
./gradlew assemblePlugin -PcameoHome="/path/to/CatiaMagic"

输出转到 plugin/build/plugin-dist/com.claude.cameo.bridge/.

独立运行MCP服务器

python -m cameo_mcp.server

这将启动stdio上的MCP服务器。除非Cameo在加载插件的情况下运行，否则它将无法连接到Java插件。

添加新工具

1. 在相应的Java处理程序类中添加HTTP处理程序方法
2. 在中注册路线 HttpBridgeServer.registerHandlers()
3. 在中添加异步客户端函数 client.py
4. 在中添加带有docstring的MCP工具函数 server.py

MCP工具的文档字符串至关重要——它们是AI的使用手册。包括有效值、示例、常见错误和相关工具的交叉引用。

贡献

欢迎问题和拉取请求。如果你正在为其他MBSE工具构建类似的东西，让我们谈谈。

捐款特别有价值的领域：

• 附加元素和关系类型支持
• 批量操作端点
• 测试覆盖率
• 支持Cameo Teamwork Cloud项目
• SysML v2配置文件支持

许可证

麻省理工学院

相关：MBSE代理商

与...一起使用 mbse代理商 用于航空航天、国防、汽车和医疗设备领域的标准感知建模。代理提供从业者级领域知识（ARP4754A、DoDAF、ISO 26262、IEC 62304）。这座桥提供了直接的工具通道。一起：一个知道子句级别标准的AI，可以修改你的Cameo模型。