dsh-cordis-mcp

Expone el conjunto de herramientas dinámicas de Cordis de DeepSeek Harness a Claude Code mediante MCP (Streamable HTTP): Claude Code puede cargar, definir, ejecutar, actualizar, detener y eliminar los plugins dinámicos de DSH en tiempo real, con exactamente las mismas capacidades que en una sesión de DSH usando cordis_define / cordis_run / cordis_stop / cordis_undefine / cordis_inspect_*, y el mismo agente de ejecución.

┌─────────────┐   MCP (Streamable HTTP, loopback)   ┌───────────────────────────┐
│ Claude Code │ ────── http://127.0.0.1:8090/mcp ──▶ │ DSH host (本插件)           │
│  (claude)   │ ────── JSON-RPC 2.0 ───────────────▶ │  dynamicCordisRunner      │
└─────────────┘                                       │  cordisInspect            │
                                                      │  agents (会话解析)         │
                                                      └───────────────────────────┘

Los plugins se montan en el puerto web existente, sin abrir puertos nuevos ni publicar servicios; el endpoint MCP exige autenticación Bearer y el token se configura en la página Configuración de DSH → dsh-cordis-mcp (se genera automáticamente la primera vez; se puede personalizar o regenerar).

Capacidades (10 herramientas)

Los paquetes con parte Client siguen pasando por el flujo de aprobación de DSH en su primera ejecución: dsh_plugin_run devuelve awaiting-approval y se completa de forma asíncrona tras hacer clic en Permitir en la tarjeta Run de la GUI web de DSH, igual que en una sesión de DSH.

Related MCP server: engine

Instalación con un clic

curl -fsSL https://raw.githubusercontent.com/GeekRicardo/dsh-cordis-mcp/main/install.sh | bash

Lo que hace el script (puedes previsualizarlo con --dry-run):

1. Escribe la dependencia "dsh-cordis-mcp": "github:GeekRicardo/dsh-cordis-mcp" en ~/.dsh/profiles/web/package.json;

2. Añade dsh-cordis-mcp a dsh.profile.bundles;

3. cd ~/.dsh/profiles/web && pnpm install;

4. Verifica que los bundles están registrados y sugiere reiniciar.

Tras reiniciar DSH y hacer un refresco forzado de la página, el endpoint MCP queda listo junto con el servicio web:

pm2 restart dsh-web   # 若用 pm2 托管；否则用你的启动方式重启

Conexión con Claude Code

# 端口换成你 DSH web 的实际端口（启动日志会打印完整地址）
claude mcp add dsh --transport http http://127.0.0.1:8090/mcp
claude mcp list          # 确认 connected

Autenticación (obligatoria, no se puede conectar directamente)

El endpoint MCP exige autenticación Bearer; cualquier petición sin token recibe 401 (503 si no hay token configurado). El token se configura en la página Configuración de DSH → dsh-cordis-mcp: se genera y persiste automáticamente en el primer uso; la página permite verlo/copiarlo/personalizarlo/regenerarlo. Introduce el token en la cabecera de .mcp.json:

{
  "mcpServers": {
    "dsh": {
      "type": "http",
      "url": "http://127.0.0.1:8090/mcp",
      "headers": { "Authorization": "Bearer <设置页里的 token>" }
    }
  }
}

Prioridad de resolución del token: configuración de la página de ajustes > variable de entorno DSH_MCP_TOKEN > generación automática. Cambiar el token surte efecto de inmediato (sin reiniciar); al regenerarlo, el token antiguo queda invalidado al instante y hay que actualizar la configuración de Claude Code.

Semántica de sesión (importante)

Los plugins dinámicos se asignan por sesión y viven en memoria del proceso (se borran al reiniciar DSH). Orden de resolución de sesión del puente:

1. sessionId en los argumentos de la llamada (se puede consultar con dsh_sessions);

2. Variable de entorno DSH_MCP_DEFAULT_SESSION;

3. La única sesión activa actual;

4. Varias sesiones activas sin especificar → error con la lista de opciones, pidiendo que se pase sessionId.

Otras variables de entorno

Límites de seguridad

• Autenticación Bearer obligatoria: sin token, siempre 401 / 503; el endpoint nunca se puede conectar directamente;

• Solo acepta Host de loopback (127.* / localhost / ::1); rechaza todo acceso externo;

• Rechaza peticiones de navegador con sec-fetch-site: cross-site y nunca devuelve cabeceras CORS — las páginas web no pueden leer la respuesta;

• La ruta de la página de ajustes /dsh-cordis-mcp/settings solo permite loopback del mismo origen (sin token MCP, pero solo modifica la configuración del token en sí);

• Este endpoint puede definir/ejecutar/eliminar plugins, equivalente a permisos de shell; no expongas el puerto fuera de la máquina local.

Cómo funciona

Desinstalación

# 1. 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 移除 "dsh-cordis-mcp"
# 2. 移除 dependencies 里的 "dsh-cordis-mcp"
# 3. cd ~/.dsh/profiles/web && pnpm install
# 4. 重启 DSH；claude mcp remove dsh

Requisitos previos

• DeepSeek Harness tiene el perfil web inicializado (existe ~/.dsh/profiles/web) y la sesión actual se ejecuta en un preset con el conjunto de herramientas de Cordis (el servicio dynamicCordisRunner del lado host existe; está presente por defecto);

• Claude Code CLI instalado en la máquina e iniciado sesión;

• Node.js ≥ 20 y pnpm disponibles.

Solución de problemas

Licencia

MIT