Xmimcp

🚀 XMI MCP Server

SysML XMIエクスポートをクエリするためのMCP（Model Context Protocol）サーバーです。このサーバーはMTConnect SysMLモデルを解析し、パッケージ、クラス、列挙型、およびドキュメントを探索するためのツールを提供します。

🚀 クイックスタート

このセクションでは、XMI MCP Serverの基本的な使い方を説明します。

📦 インストール

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に以下のようなツールを使用するように依頼することで、サーバーが読み込まれたことを確認できます。

• "Get model statistics from the XMI server"
• "List all packages in the SysML model"

📚 ドキュメント

パッケージツール

list_packages

SysMLモデル内のすべてのパッケージを、オプションでフィルタリングしてリストします。

パラメータ:

例:

名前に "Asset" を含むすべてのパッケージをリストする

get_package

特定のパッケージの詳細情報（子パッケージを含む）を取得します。

パラメータ:

戻り値: 子パッケージ、クラス、および列挙型を含むパッケージの詳細。

例:

"Asset Information Model" パッケージの詳細を取得する

クラス/ブロックツール

find_classes

名前、パターン、またはパッケージでクラス/ブロックを検索します。

パラメータ:

例:

名前に "Tool" を含むすべてのクラスを検索する
"Cutting Tool" パッケージ内のクラスを検索する

get_class_details

クラスの完全な詳細（プロパティ、継承、およびドキュメントを含む）を取得します。

パラメータ:

戻り値: 以下を含む完全なクラス情報:

• 型と多重度を持つプロパティ
• 親クラス（一般化）
• ステレオタイプ（例: SysML Block）
• ドキュメント

例:

継承プロパティを含む "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がインストールされており、PATHに含まれていることを確認します。
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