AI-to-CATIA Magic bridge for SysML v1 models. Exposes your SysML v1 project to AI agents via the Model Context Protocol (MCP).
The JGS SysML toolchain spans two MCP bridges and two skills packs. This repository is one part; the others:
| Repository | What it is | Access |
|---|---|---|
| jgs-magic-sysmlv1-mcp (this repository) | MCP bridge for live SysML v1 models in CATIA Magic (MSOSA). FREE tier is read-only; a PRO licence adds write tools, and ENTERPRISE adds administrative tools. | Free; PRO and ENTERPRISE by licence |
| jgs-magic-sysmlv2-mcp | MCP bridge for live SysML v2 models in CATIA Magic. FREE tier is read-only; a PRO licence adds write tools, and ENTERPRISE adds administrative tools. | Free; PRO and ENTERPRISE by licence |
| jgs-magic-sysmlv1-read-skills | Free read-only analysis skills for SysML v1. | Free |
| jgs-magic-sysmlv1-pro-skills | Write-capable and migration skills for SysML v1; the paid companion to the read skills. | Proprietary; request access via https://labs.jgsystemsconsulting.com/licensing.html |
Copy everything in the block below and paste it into your coding agent (Claude Code, Cursor, etc.). It will do the parts it safely can and hand back the few desktop steps it cannot do for you.
You are installing jgs-magic-sysmlv1-mcp, a proprietary MCP bridge (JG Systems Consulting
Ltd.) that lets MCP clients work with live SysML v1 models in CATIA Magic Systems of
Systems Architect (MSOSA 2026x). Repository: https://github.com/jgsystemsconsulting/jgs-magic-sysmlv1-mcp (version 0.1.1).
Do this in order:
1. Read README.md, docs/install.md, docs/configuration.md, and docs/licensing.md in
this repository so you understand the full install and prerequisites (CATIA Magic
2026x, Python >= 3.11, an MCP client such as Claude Code).
2. Do the scriptable steps: install the Python server with `pip install ./server`
(see docs/install.md for the exact command), create my MCP client config from
`examples/.mcp.json.example` (fill in placeholders; never invent secrets/tokens),
and place my licence file as described in docs/licensing.md.
3. STOP: these two steps run on my desktop app and you cannot do them for me:
a. Copy the contents of `plugin/` into my CATIA Magic user plugins directory
(the exact path is in docs/install.md).
b. Restart CATIA Magic.
Tell me the target path and wait for me to confirm I have done both.
4. After I confirm, verify the bridge by calling the `ping` MCP tool and report the
result. If it fails, walk me through docs/configuration.md.
5. This is licensed software: point me at LICENSE and docs/licensing.md and note the
FREE / PRO / ENTERPRISE tiers. Never invent, commit, or share licence keys.
This repo ships a Claude Code plugin manifest, so you can add it as a marketplace and install from inside Claude Code:
/plugin marketplace add jgsystemsconsulting/jgs-magic-sysmlv1-mcp
/plugin install jgs-magic-sysmlv1-mcp
The marketplace install registers the bridge; the desktop steps (CATIA Magic plugin JAR
- restart) still run on your machine. See docs/install.md.
plugin/: CATIA Magic plugin JAR (copy to your plugins directory)server/: Python MCP server (install withpip install ./server)docs/: Installation guide, usage guide, and configuration referencetools/: Licence verification utilityexamples/: Sample.mcp.jsonconfiguration
See docs/install.md for full installation instructions.
docs/usage.md walks the first session and the everyday workflows: exploring the model, auditing requirement coverage, authoring a change under a PRO licence, and producing diagrams. The per-tool reference is docs/TOOL-REFERENCE.md.
- CATIA Magic Systems of Systems Architect 2026x
- Python 3.11 or later
- Support / licensing: JG Systems Consulting Ltd. To request a commercial or academic licence, or if you are unsure which licence you need, see https://labs.jgsystemsconsulting.com/licensing.html
- Security issues: open a private security advisory on this repository. Please do not open public issues for vulnerabilities, and do not email keys or licence material.
- Bugs (agents and humans): if a tool returns malformed or incorrect output, open
an issue with the Bug Report form at
https://github.com/jgsystemsconsulting/jgs-magic-sysmlv1-mcp/issues/new/choose.
Include the server version (from
ping), the tool name, and the exact tool call and its output. - Improvements: use the Improvement form on the same issue chooser. Include the version from RELEASE-INFO.txt and the outcome the bridge could not enable.
This is a release repo. The server and plugin ship from this tree and fixes are applied upstream by the maintainer, so please file an issue rather than a pull request.
Proprietary: see LICENSE and docs/licensing.md.
To request a commercial or academic licence, or if you are unsure which licence you need: https://labs.jgsystemsconsulting.com/licensing.html
Copyright (c) 2026 JG Systems Consulting Ltd. All Rights Reserved.