Enables querying and exploration of SysML models stored in XMI (XML) format, providing tools to navigate package hierarchies, find classes and blocks, inspect enumeration values, and perform full-text searches across model documentation.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@XMI MCP Servershow the inheritance hierarchy and properties for the Asset class"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
XMI MCP Server
An MCP (Model Context Protocol) server for querying SysML XMI exports. This server parses the MTConnect SysML model and provides tools for exploring packages, classes, enumerations, and documentation.
Installation
Loading into Claude Code on Windows
Option 1: Add to User Settings (Recommended)
Open your Claude Code settings file at:
%APPDATA%\Claude\claude_desktop_config.jsonOr create it if it doesn't exist.
Add the MCP server configuration:
{ "mcpServers": { "xmimcp": { "command": "node", "args": ["C:\\source\\vibes\\xmimcp\\dist\\index.js"] } } }Restart Claude Code for the changes to take effect.
Option 2: Using a Custom XMI File Path
If your XMI file is in a different location, set the XMI_FILE_PATH environment variable:
Option 3: Project-Specific Configuration
Create a .mcp.json file in your project root:
Verifying the Server is Loaded
After restarting Claude Code, you can verify the server is loaded by asking Claude to use one of the tools, such as:
"Get model statistics from the XMI server"
"List all packages in the SysML model"
Tool Reference
Package Tools
list_packages
List all packages in the SysML model with optional filtering.
Parameters:
Parameter | Type | Description |
| string | Filter to children of this package (by name or xmi:id) |
| boolean | Include nested packages recursively (default: false) |
| string | Regex pattern to filter package names |
Example:
get_package
Get detailed information about a specific package including its children.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Package name or xmi:id |
Returns: Package details including child packages, classes, and enumerations.
Example:
Class/Block Tools
find_classes
Find classes/blocks by name, pattern, or package.
Parameters:
Parameter | Type | Description |
| string | Exact class name to find |
| string | Regex pattern for class names |
| string | Limit search to this package (name or id) |
| boolean | Search in nested packages (default: true) |
| boolean | Include abstract classes (default: true) |
Example:
get_class_details
Get full details of a class including properties, inheritance, and documentation.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Class name or xmi:id |
| boolean | No | Include inherited properties from parent classes (default: false) |
Returns: Complete class information including:
Properties with types and multiplicity
Parent classes (generalizations)
Stereotypes (e.g., SysML Block)
Documentation
Example:
get_inheritance_hierarchy
Get the inheritance chain for a class showing ancestors and/or descendants.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Class name or xmi:id |
| string | No | One of: "ancestors", "descendants", "both" (default: "both") |
Example:
Enumeration Tools
list_enumerations
List all enumerations with optional filtering.
Parameters:
Parameter | Type | Description |
| string | Filter to a specific package |
| string | Regex pattern for enumeration names |
Example:
get_enumeration
Get details of an enumeration including all literal values and their documentation.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Enumeration name or xmi:id |
Returns: Enumeration details with all literals and their documentation.
Example:
Search Tools
search_documentation
Full-text search across all documentation and comments in the model.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Search terms (space-separated, all must match) |
| array | No | Limit to: "class", "enumeration", "package", "datatype" |
| number | No | Maximum results (default: 50) |
Example:
search_by_name
Search for any element by name across the entire model.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Name or partial name to search for |
| boolean | No | Require exact name match (default: false) |
| array | No | Limit to: "class", "enumeration", "package", "datatype" |
Example:
Reference Tools
resolve_reference
Resolve an xmi:id reference to get element details. Useful for following cross-references in the model.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | The xmi:id to resolve |
Example:
Utility Tools
get_model_statistics
Get statistics about the loaded SysML model.
Parameters: None
Returns:
Troubleshooting
Server not loading
Ensure Node.js is installed and in your PATH
Verify the paths in the configuration use double backslashes (
\\) on WindowsCheck that
npm run buildcompleted successfully
XMI file not found
Verify the XMI file exists at the expected path
Use the
XMI_FILE_PATHenvironment variable to specify a custom location
Tools not appearing
Restart Claude Code after updating the configuration
Check the Claude Code logs for any error messages
Development
License
MIT