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 許可證。