Xmimcp

🚀 XMI MCP 服务器

这是一个用于查询 SysML XMI 导出文件的 MCP（模型上下文协议）服务器。该服务器能够解析 MTConnect SysML 模型，并提供用于探索包、类、枚举和文档的工具。

🚀 快速开始

本项目是一个用于查询 SysML XMI 导出文件的 MCP 服务器，你可以按照以下步骤进行安装和配置。

📦 安装指南

npm install
npm run build

💻 使用示例

在 Windows 系统的 Claude Code 中加载

选项 1：添加到用户设置（推荐）

1. 打开你的 Claude Code 设置文件，路径为：

   %APPDATA%\Claude\claude_desktop_config.json
   

若该文件不存在，则创建一个。 2. 添加 MCP 服务器配置：

{
  "mcpServers": {
    "xmimcp": {
      "command": "node",
      "args": ["C:\\source\\vibes\\xmimcp\\dist\\index.js"]
    }
  }
}

3. 重启 Claude Code 使更改生效。

选项 2：使用自定义 XMI 文件路径

如果你的 XMI 文件位于其他位置，请设置 XMI_FILE_PATH 环境变量：

{
  "mcpServers": {
    "xmimcp": {
      "command": "node",
      "args": ["C:\\source\\vibes\\xmimcp\\dist\\index.js"],
      "env": {
        "XMI_FILE_PATH": "C:\\path\\to\\your\\model.xml"
      }
    }
  }
}

选项 3：项目特定配置

在项目根目录下创建一个 .mcp.json 文件：

{
  "mcpServers": {
    "xmimcp": {
      "command": "node",
      "args": ["C:\\source\\vibes\\xmimcp\\dist\\index.js"]
    }
  }
}

验证服务器是否已加载

重启 Claude Code 后，你可以通过要求 Claude 使用其中一个工具来验证服务器是否已加载，例如：

• "从 XMI 服务器获取模型统计信息"
• "列出 SysML 模型中的所有包"

📚 详细文档

工具参考

包工具

list_packages

列出 SysML 模型中的所有包，并可进行可选的过滤。 参数：

列出名称中包含 "Asset" 的所有包

get_package

获取特定包的详细信息，包括其子包。 参数：

获取 "Asset Information Model" 包的详细信息

类/块工具

find_classes

按名称、模式或包查找类/块。 参数：

查找名称中包含 "Tool" 的所有类
查找 "Cutting Tool" 包中的类

get_class_details

获取类的完整详细信息，包括属性、继承和文档。 参数：

• 具有类型和多重性的属性
• 父类（泛化）
• 构造型（例如，SysML 块）
• 文档 示例：

获取包含继承属性的 "CuttingTool" 类的详细信息

get_inheritance_hierarchy

获取类的继承链，显示祖先和/或后代。 参数：

显示 "Asset" 类的继承层次结构

枚举工具

list_enumerations

列出所有枚举，并可进行可选的过滤。 参数：

列出名称中包含 "Type" 的所有枚举

get_enumeration

获取枚举的详细信息，包括所有字面量值及其文档。 参数：

获取 "DataItemSubTypeEnum" 枚举的所有值

搜索工具

search_documentation

对模型中的所有文档和注释进行全文搜索。 参数：

在文档中搜索 "cutting tool life"
仅在类文档中搜索 "spindle"

search_by_name

在整个模型中按名称搜索任何元素。 参数：

搜索名称为 "Asset" 的元素
查找所有包含 "Observation" 的元素

引用工具

resolve_reference

解析 xmi:id 引用以获取元素详细信息。这对于跟踪模型中的交叉引用很有用。 参数：

解析引用 "_19_0_3_68e0225_1620206731259_178927_703"

实用工具

get_model_statistics

获取已加载的 SysML 模型的统计信息。 参数： 无 返回值：

{
  "packageCount": 120,
  "classCount": 1179,
  "enumerationCount": 106,
  "dataTypeCount": 30,
  "propertyCount": 1924,
  "associationCount": 231
}

故障排除

服务器未加载

1. 确保已安装 Node.js 并将其添加到系统路径中。
2. 验证配置中的路径在 Windows 系统上使用双反斜杠 (\\)。
3. 检查 npm run build 是否成功完成。

未找到 XMI 文件

1. 验证 XMI 文件是否存在于预期的路径中。
2. 使用 XMI_FILE_PATH 环境变量指定自定义位置。

工具未显示

1. 更新配置后重启 Claude Code。
2. 检查 Claude Code 日志中是否有任何错误消息。

开发

# 安装依赖项
npm install

# 构建
npm run build

# 直接运行（用于测试）
npm start

📄 许可证

本项目采用 MIT 许可证。