# JGS SysML v1 MCP Bridge [](https://glama.ai/mcp/servers/jgsystemsconsulting/jgs-magic-sysmlv1-mcp) AI-to-CATIA Magic bridge for SysML v1 models. Exposes your SysML v1 project to AI agents via the Model Context Protocol (MCP). ## Related repositories 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](https://github.com/jgsystemsconsulting/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](https://github.com/jgsystemsconsulting/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 | ## Install with your AI agent 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. ```text 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. ``` ## Install from the Claude Code marketplace This repo ships a Claude Code plugin manifest, so you can add it as a marketplace and install from inside Claude Code: ```text /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](docs/install.md). ## What's Included - `plugin/`: CATIA Magic plugin JAR (copy to your plugins directory) - `server/`: Python MCP server (install with `pip install ./server`) - `docs/`: Installation guide, usage guide, and configuration reference - `tools/`: Licence verification utility - `examples/`: Sample `.mcp.json` configuration ## Quick Start See [docs/install.md](docs/install.md) for full installation instructions. ## Usage [docs/usage.md](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](docs/TOOL-REFERENCE.md). ## Requirements - CATIA Magic Systems of Systems Architect 2026x - Python 3.11 or later ## Support & Security - **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](https://github.com/jgsystemsconsulting/jgs-magic-sysmlv1-mcp/security/advisories/new) 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](https://github.com/jgsystemsconsulting/jgs-magic-sysmlv1-mcp/issues/new/choose). 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. ## Licence Proprietary: see [LICENSE](LICENSE) and [docs/licensing.md](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.