Плагин MCP для Claude Code DTS

Приватный плагин Claude Code для шлюза DTS Engine по адресу https://192.168.50.170:8770/mcp.

Он позволяет Claude Code на macOS или Windows загружать исходные данные, ставить в очередь задания публикации Windows DTS Engine 6.1, отслеживать их и скачивать результаты 3DT с проверкой хеша. Плагин не содержит бинарных файлов DTS Engine и секретов сервера.

Это аналог плагина Claude Code для codex-dts-mcp-plugin, который обслуживает тот же шлюз для Codex на macOS. Оба плагина могут использовать один и тот же сохраненный токен-носитель, поскольку они нацелены на один и тот же шлюз и одну и ту же переменную окружения DTS_MCP_TOKEN.

Предварительные требования

• Клиентская машина может маршрутизироваться к 192.168.50.170:8770 через частную локальную сеть или VPN.

• Доступ к GitHub для клонирования zhouning/claudecode-dts-mcp-plugin.

• Установлен CLI Claude Code (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

Скрипт импортирует только общедоступный CA DTS MCP в связку ключей входа, сохраняет токен-носитель под службой dts-mcp, устанавливает пользовательский LaunchAgent, который восстанавливает DTS_MCP_TOKEN, добавляет маркетплейс 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 как переменную окружения пользователя и транслирует изменение, чтобы новые процессы его видели, доверяет встроенному CA в Cert:\CurrentUser\Root, добавляет маркетплейс 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 или CA DTS MCP обновите репозиторий и выполните:

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

Удалите сертификат DTS MCP Local CA из связки ключей входа (security delete-certificate) или Cert:\CurrentUser\Root (Remove-Item) только после подтверждения его отпечатка.

Ограничения публикации

• Проверен только road от начала до конца.

• Входные данные дороги требуют проекции CRS и domPath; настоятельно рекомендуется соответствующая DEM.

• Публикация OSGB требует обоих этапов и должна использовать dts_publish_osgb.

• Флаги удаленного пути используют идентификаторы артефактов и пути относительно артефактов, никогда не пути Windows.

• Байты загрузки и скачивания используют подписанные URL-адреса HTTPS без токена-носителя.

• Удаленный шлюз регистрирует 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.