dsh-mcp-admin

Expone la gestión de skills y presets de agente de DeepSeek Harness como un plugin de doble cara de servidor MCP: los agentes remotos modifican directamente la configuración de skills/presets del servidor mediante el protocolo MCP, sin necesidad de SSH; la mitad host registra registros de auditoría, y la mitad del navegador ofrece un panel «gestión de MCP» en la página Settings que muestra los cambios recientes.

Uso típico: ejecuta dsh web en un servidor remoto, y el Agent local se conecta a http://<服务器>:3080/mcp, formando un ciclo cerrado de «producción → revisión → modificación → reproducción».

Arquitectura

本地 Agent (MCP client)
   │  POST /mcp  (Authorization: Bearer <token>)
   ▼
dsh web (host 半区)
   ├── Streamable HTTP MCP server（stateless，每请求一个实例）
   │     ├── skill_list / skill_read / skill_upsert / skill_delete
   │     └── preset_list / preset_read / preset_upsert / preset_delete
   ├── 审计 JSONL：$DSH_HOME/mcp-admin/audit.jsonl
   └── RPC 通道 /mcp-admin（audit.list，trusted-host 围栏）
        ▲
浏览器 Settings「MCP 管理」看板（client 半区，5s 轮询）

• Escritura de skill: escribe directamente en $DSH_HOME/skills/<name>/SKILL.md (bundle de directorio; si ya existe un <name>.md plano, se sobrescribe en el lugar conservando la forma). El provider skill-filesystem de harness observa ese directorio; el cambio se aplica en el siguiente paso del agente.

• Escritura de preset: escribe en $DSH_HOME/.agent-presets/<id>/agent.cordis.yml. Para sobrescribir un preset de confianza del sistema, primero hay que pasar base para copiarlo a la raíz de usuario (evitando así ocultar sin querer el preset integrado desde cero). El mecanismo de marcas de tiempo de archivo de standing mount hace que los cambios se apliquen automáticamente a las nuevas sesiones, sin necesidad de reiniciar; las sesiones en curso no se ven afectadas.

• Auditoría: cada escritura/eliminación añade una línea JSONL (hora, herramienta, objetivo, acción, número de bytes, resumen de los primeros 200 caracteres del contenido), truncada según auditLimit.

Related MCP server: Omni Skills

Instalación

dsh plugin --profile web add /path/to/dsh-mcp-admin

Luego configura el token en ~/.dsh/profiles/web/cordis.patch.yml del perfil (obligatorio; de lo contrario el plugin se niega a arrancar):

- id: mcp-admin
  config:
    token: <openssl rand -hex 32 的输出>
    auditLimit: 200

Configuración

Configuración del cliente MCP

La forma más sencilla: abre la página «gestión de MCP» de Settings, primero rellena «dirección de acceso público» con la dirección pública/LAN de este despliegue (p. ej. http://1.2.3.4:3080; obligatorio en máquinas NAT; si se deja vacío, se usará la dirección desde la que abriste esta página), guarda y pulsa «copiar instrucciones de configuración de MCP»: se copiará un conjunto completo de instrucciones (con URL y token) que puedes pegar directamente al Agent que quieras configurar; él mismo se configurará siguiendo las instrucciones. Ten en cuenta que en páginas http:// el navegador bloquea el copiado automático; el botón se degrada a mostrar un cuadro de texto para copiar manualmente.

Formato de configuración manual (tipo Streamable HTTP):

{
  "mcpServers": {
    "dsh-admin": {
      "type": "http",
      "url": "http://<服务器>:3080/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Lista de herramientas

Notas de seguridad

• El servidor web de harness no tiene TLS ni autenticación; /mcp queda fuera de la valla de confianza de /api; token es la única línea de defensa. Si el token se filtra, la otra parte puede reescribir tus skills y presets (ejecución remota de código indirecta).

• Se recomienda exponerlo solo tras terminar TLS en un proxy inverso, o combinarlo con el mecanismo trusted-host de harness para restringir el origen.

• Todas las operaciones de escritura se limitan a la raíz de usuario (~/.dsh/skills, ~/.dsh/.agent-presets); no tocan los presets integrados ni los directorios del proyecto.

• El canal RPC del panel (/mcp-admin) pasa por la valla trusted-host de la conexión; los registros de auditoría no contienen secretos.

• El botón «copiar instrucciones de configuración de MCP» devuelve el token a la página a través del endpoint setup-info: cualquiera que pueda abrir la Web UI puede obtener el token. Esto es coherente con el modelo de seguridad actual de harness (quien puede abrir la Web UI ya puede ejecutar agentes en el servidor mediante session.prompt), pero implica que la superficie de exposición de la Web UI equivale a la superficie de exposición del token.

Desarrollo

pnpm install
pnpm run build        # host: tsc → lib/；client: tsdown → lib/client.js
pnpm run typecheck

La resolución de tipos de la mitad cliente depende del árbol de fuentes local de harness (dsh-client-* no está publicado completo en npm); los paths en tsconfig*.json apuntan de forma fija al checkout de harness; al migrar de máquina hay que cambiar esas rutas.