Complemento MCP de Claude Code para DTS

Complemento privado de Claude Code para la puerta de enlace DTS Engine en https://192.168.50.170:8770/mcp.

Permite que Claude Code en macOS o Windows cargue datos de origen, ponga en cola trabajos de publicación de DTS Engine 6.1 para Windows, los supervise y descargue resultados 3DT verificados por hash. El complemento no contiene binarios de DTS Engine ni secretos del servidor.

Esta es la contraparte de Claude Code de codex-dts-mcp-plugin, que sirve a la misma puerta de enlace para Codex en macOS. Ambos complementos pueden compartir el mismo token de portador almacenado porque se dirigen a la misma puerta de enlace y a la misma variable de entorno DTS_MCP_TOKEN.

Requisitos previos

• La máquina cliente puede enrutar a 192.168.50.170:8770 a través de la LAN privada o VPN.

• El acceso a GitHub puede clonar zhouning/claudecode-dts-mcp-plugin.

• La CLI de Claude Code está instalada (claude plugin --help se ejecuta correctamente).

• La puerta de enlace MCP de Windows DTS está en buen estado y DTS Engine está instalado, con licencia y ejecutándose en una sesión interactiva de Windows iniciada.

• Tiene el Token de Portador de la puerta de enlace a través de un canal seguro.

No pegue el token en un comando de shell. Ambos instaladores solicitan sin eco en la terminal: configure-macos.sh lo almacena en el Llavero de inicio de sesión de macOS, configure-windows.ps1 lo almacena en el Administrador de credenciales de Windows.

Instalar en macOS

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

El script importa solo la CA pública de MCP de DTS en el Llavero de inicio de sesión, almacena el Token de Portador bajo el servicio dts-mcp, instala un LaunchAgent de usuario que restaura DTS_MCP_TOKEN, agrega el market zhouning-dts, instala dts-mcp@zhouning-dts y verifica el endpoint de salud fijo.

Verifique con:

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

Instalar en Windows

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

El script almacena el Token de Portador como una Credencial Genérica en el Administrador de credenciales de Windows bajo el destino dts-mcp, persiste DTS_MCP_TOKEN como una variable de entorno de usuario y transmite el cambio para que los nuevos procesos lo vean, confía en la CA incluida en Cert:\CurrentUser\Root, agrega el market zhouning-dts, instala dts-mcp@zhouning-dts y verifica el endpoint de salud fijo.

Verifique con:

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

Reinicie Claude Code y abra una nueva sesión después de la instalación en cualquier plataforma.

Actualizar

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

Reinicie Claude Code y use una nueva sesión después de una actualización.

Rotar el Token de Portador

Rote el token en la puerta de enlace de Windows primero, luego ejecute:

./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

Actualizar la CA

Después de que la dirección del host de Windows o la CA de MCP de DTS cambien, actualice el checkout y ejecute:

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

La actualización no lee ni reescribe el Token de Portador. Descarte las URL firmadas emitidas antes de un cambio de endpoint o clave de firma.

Eliminar

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

Elimine el certificado DTS MCP Local CA del Llavero de inicio de sesión (security delete-certificate) o Cert:\CurrentUser\Root (Remove-Item) solo después de confirmar su huella digital.

Restricciones de publicación

• Solo road está verificado de extremo a extremo.

• Las entradas de carretera requieren un CRS proyectado y domPath; se recomienda encarecidamente un DEM coincidente.

• La publicación OSGB requiere ambas etapas y debe usar dts_publish_osgb.

• Las banderas de ruta remota usan IDs de artefacto y rutas relativas al artefacto, nunca rutas de Windows.

• Los bytes de carga y descarga usan URL HTTPS firmadas sin el Token de Portador.

• La puerta de enlace remota registra 14 herramientas; dts_validate permanece solo local.

• Un ZIP de resultado exitoso debe conservar tanto sus datos .3dt como DataInfor.txt.

Orden de solución de problemas

1. Confirme el enrutamiento privado a 192.168.50.170:8770.

2. Confirme que el host de Windows haya iniciado sesión y que la puerta de enlace MCP de DTS esté en buen estado.

3. Ejecute el script verify-connection-* de la plataforma y solucione la primera capa fallida.

4. Use --rotate-token para fallos de autenticación.

5. Use --refresh-ca después de un cambio de dirección o certificado.

6. Confirme que dts-mcp aparece en claude plugin list.

7. Confirme que dts aparece en claude mcp list.

8. Inicie una nueva sesión de Claude Code y llame a dts_ping.

Estado de verificación

• Implementación de la puerta de enlace remota del servidor DTS y su propia prueba de humo remota: no verificado nuevamente desde este repositorio; consulte zhouning/dts-mcp-server.

• Manifiestos del complemento, Skill, certificado, sintaxis de scripts y comprobaciones de secretos: cubiertos por las pruebas de este repositorio.

• La aceptación del Administrador de credenciales de Windows y del Llavero de macOS está pendiente en las máquinas de destino.

• No informe el éxito del complemento de extremo a extremo hasta que una máquina de destino complete una carga, publicación, descarga y verificación SHA-256 reales de una carretera.