Claude Code DTS MCP プラグイン

https://192.168.50.170:8770/mcp にある DTS Engine ゲートウェイ向けのプライベート Claude Code プラグインです。

これにより、macOS または Windows 上の Claude Code がソースデータをアップロードし、Windows DTS Engine 6.1 のパブリッシングジョブをキューに入れ、監視し、ハッシュ検証された 3DT 結果をダウンロードできるようになります。このプラグインには DTS Engine バイナリもサーバーシークレットも含まれていません。

これは、macOS 上の Codex に同じゲートウェイを提供する codex-dts-mcp-plugin に対応する Claude Code 版です。両方のプラグインは同じゲートウェイと同じ DTS_MCP_TOKEN 環境変数をターゲットにしているため、同じ保存済みベアラートークンを共有できます。

前提条件

• クライアントマシンがプライベート LAN または VPN 経由で 192.168.50.170:8770 にルーティングできること。

• GitHub アクセスで zhouning/claudecode-dts-mcp-plugin をクローンできること。

• Claude Code CLI がインストールされていること（claude plugin --help が成功すること）。

• Windows DTS MCP ゲートウェイが正常であり、DTS Engine がインストール、ライセンス認証され、ログインした対話型 Windows セッションで実行中であること。

• 安全なチャネルを通じてゲートウェイのベアラートークンを保持していること。

トークンをシェルコマンドに貼り付けないでください。両方のインストーラーは端末エコーなしでプロンプトを表示します。configure-macos.sh は macOS ログインキーチェーンに保存し、configure-windows.ps1 は Windows 資格情報マネージャーに保存します。

macOS にインストール

git clone git@github.com:zhouning/claudecode-dts-mcp-plugin.git
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh

このスクリプトは、公開 DTS MCP CA のみをログインキーチェーンにインポートし、ベアラートークンをサービス dts-mcp として保存し、DTS_MCP_TOKEN を復元するユーザー LaunchAgent をインストールし、zhouning-dts マーケットプレイスを追加し、dts-mcp@zhouning-dts をインストールし、固定されたヘルスエンドポイントを検証します。

以下で検証します：

./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/verify-connection-macos.sh

Windows にインストール

git clone https://github.com/zhouning/claudecode-dts-mcp-plugin.git
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1

このスクリプトは、ベアラートークンを Windows 資格情報マネージャーのターゲット dts-mcp の汎用資格情報として保存し、DTS_MCP_TOKEN をユーザー環境変数として永続化し、変更をブロードキャストして新しいプロセスが認識するようにし、Cert:\CurrentUser\Root にバンドルされた CA を信頼し、zhouning-dts マーケットプレイスを追加し、dts-mcp@zhouning-dts をインストールし、固定されたヘルスエンドポイントを検証します。

以下で検証します：

.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\verify-connection-windows.ps1

インストール後、Claude Code を再起動し、新しいセッションを開いてください。

アップデート

git -C claudecode-dts-mcp-plugin pull --ff-only
claude plugin marketplace update zhouning-dts
claude plugin install dts-mcp@zhouning-dts

アップデート後、Claude Code を再起動し、新しいセッションを使用してください。

ベアラートークンのローテーション

まず Windows ゲートウェイでトークンをローテーションし、次に以下を実行します：

./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh --rotate-token

.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1 --rotate-token

CA の更新

Windows ホストアドレスまたは DTS MCP CA が変更された後、チェックアウトを更新して以下を実行します：

git -C claudecode-dts-mcp-plugin pull --ff-only
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/configure-macos.sh --refresh-ca
./claudecode-dts-mcp-plugin/plugins/dts-mcp/scripts/verify-connection-macos.sh

git -C claudecode-dts-mcp-plugin pull --ff-only
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\configure-windows.ps1 --refresh-ca
.\claudecode-dts-mcp-plugin\plugins\dts-mcp\scripts\verify-connection-windows.ps1

更新ではベアラートークンの読み取りや書き換えは行いません。エンドポイントまたは署名キーが変更される前に発行された署名付き URL は破棄してください。

削除

macOS：

claude plugin uninstall dts-mcp
claude plugin marketplace remove zhouning-dts
launchctl bootout "gui/$UID/com.dts.mcp.token" 2>/dev/null || true
rm -f "$HOME/Library/LaunchAgents/com.dts.mcp.token.plist"
rm -rf "$HOME/Library/Application Support/dts-mcp"
security delete-generic-password -a "$USER" -s dts-mcp
launchctl unsetenv DTS_MCP_TOKEN

Windows：

claude plugin uninstall dts-mcp
claude plugin marketplace remove zhouning-dts
[Environment]::SetEnvironmentVariable('DTS_MCP_TOKEN', $null, 'User')
cmdkey /delete:dts-mcp 2>$null

指紋を確認した後にのみ、ログインキーチェーン（security delete-certificate）または Cert:\CurrentUser\Root（Remove-Item）から DTS MCP Local CA 証明書を削除してください。

パブリッシングの制約

• road のみがエンドツーエンドで検証されています。

• Road 入力には投影 CRS と domPath が必要であり、一致する DEM が強く推奨されます。

• OSGB パブリッシングには両方のステージが必要であり、dts_publish_osgb を使用する必要があります。

• リモートパスフラグはアーティファクト ID とアーティファクト相対パスを使用し、Windows パスは使用しません。

• アップロードおよびダウンロードのバイトは、ベアラートークンなしで署名付き HTTPS URL を使用します。

• リモートゲートウェイは 14 のツールを登録します。dts_validate はローカルのみのままです。

• 成功した結果 ZIP には、.3dt データと DataInfor.txt の両方が保持されている必要があります。

トラブルシューティングの順序

1. 192.168.50.170:8770 へのプライベートルーティングを確認します。

2. Windows ホストがログインしており、DTS MCP ゲートウェイが正常であることを確認します。

3. プラットフォームの verify-connection-* スクリプトを実行し、最初に失敗したレイヤーを修正します。

4. 認証エラーの場合は --rotate-token を使用します。

5. アドレスまたは証明書の変更後は --refresh-ca を使用します。

6. dts-mcp が claude plugin list に表示されることを確認します。

7. dts が claude mcp list に表示されることを確認します。

8. 新しい Claude Code セッションを開始し、dts_ping を呼び出します。

検証ステータス

• DTS サーバーのリモートゲートウェイ実装およびその独自のリモートスモークテスト：このリポジトリからは再検証されていません。zhouning/dts-mcp-server を参照してください。

• プラグインマニフェスト、スキル、証明書、スクリプト構文、およびシークレットチェック：このリポジトリのテストでカバーされています。

• Windows 資格情報マネージャーと macOS キーチェーンの受け入れは、ターゲットマシンでのテスト待ちです。

• ターゲットマシンが実際の道路アップロード、パブリッシュ、ダウンロード、および SHA-256 検証を完了するまで、エンドツーエンドのプラグイン成功を報告しないでください。