# OpenSysML MCP server

> OpenSysML MCP server is an open-source MCP server for developer tools. Check, edit and run SysML v2 and KerML models from a coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://runtime.opensysml.org/reference/sysml-mcp/
- **Repository:** https://github.com/open-mbee/opensysml/tree/HEAD/cmd/sysml-mcp
- **MCP Registry name:** org.opensysml/sysml-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

SysML v2 is a modeling language for systems engineering, and this server lets a coding agent work on it the way it would on source code. It starts as a local process in the project directory and treats every document under the workspace root as one workspace, so a declaration in one file resolves against the others. The standard library is embedded in the binary unless you point it elsewhere.

The tools cover three layers: the language server's diagnostics, navigation, editing and rendering; the runtime's one-shot parsing, evaluation, instantiation, execution, verification, querying and conversion; and named REPL sessions whose declarations and runs persist across calls. Running the model is the point. The project describes finding defects that reading cannot, such as a mass rollup with one unvalued leaf or a calculation that returns the wrong dimension.

Install with `npx -y @openmbee/sysml-mcp`, which picks a platform binary for Linux, macOS or Windows, or use the release archives, Homebrew, Scoop or the Windows MSI. Passing `-http` serves several agents over Streamable HTTP instead of stdio. It comes from the OpenMBEE community's OpenSysML project.

## Features

- **Workspace diagnostics:** Reports problems across all documents under the workspace root.
- **Model execution:** Instantiates and runs models, evaluating features with units checked.
- **Persistent REPL sessions:** Named sessions keep declarations and runs between calls.
- **Editing and navigation:** Exposes the language server's edit, navigation and rendering features.
- **Embedded standard library:** Ships the SysML library inside the binary.
- **Stdio or HTTP:** Runs over stdio by default, or as one shared Streamable HTTP server.

## Good for

- Have an agent fix validation errors in a SysML v2 model
- Run a model to catch an incomputable mass rollup
- Query and convert model content
- Try declarations interactively in a REPL session

## Install

### Claude Code (Terminal)

```sh
claude mcp add sysml-mcp -- npx -y @openmbee/sysml-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sysml-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openmbee/sysml-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sysml-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openmbee/sysml-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sysml-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openmbee/sysml-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sysml-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openmbee/sysml-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sysml-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@openmbee/sysml-mcp"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

Run `npx -y @openmbee/sysml-mcp -root .`, which needs Node 20.11 or later, or use release archives, Homebrew, Scoop or the Windows MSI.

### Which platforms does it run on?

Linux and macOS on x64 and arm64, and Windows on x64.

### Can several agents share one server?

Yes. The `-http` flag serves every agent over Streamable HTTP.

### Does the project claim standard conformance?

No conformance certification is claimed. Diagnostics are compared against the OMG pilot implementation.

### Is OpenSysML MCP server free?

Yes. OpenSysML MCP server is open source, so you can use and self-host it for free.

### How do I add OpenSysML MCP server to Claude Code?

Run this command in your terminal: claude mcp add sysml-mcp -- npx -y @openmbee/sysml-mcp

### What are the best alternatives to OpenSysML MCP server?

The closest alternatives to OpenSysML MCP server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/opensysml-mcp-server
