dsh-mcp-admin

Представляет управление навыками и пресетами агентов DeepSeek Harness как двусторонний плагин MCP server: удалённые агенты напрямую изменяют конфигурацию навыков/пресетов на сервере через протокол MCP, без SSH; host-половина ведёт журнал аудита, браузерная половина на странице Settings предоставляет панель «Управление MCP» для отображения последних изменений.

Типичное использование: запустите dsh web на удалённом сервере, локальный агент подключается к http://<сервер>:3080/mcp, образуя цикл «производство → рецензирование → изменение → повторное производство».

Архитектура

本地 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 轮询）

• Запись навыка: напрямую записывает $DSH_HOME/skills/<name>/SKILL.md (каталог bundle; если уже есть плоский <name>.md, перезаписывает на месте, сохраняя форму). Провайдер skill-filesystem harness'а следит за этим каталогом, изменения вступают в силу на следующем шаге агента.

• Запись пресета: записывает $DSH_HOME/.agent-presets/<id>/agent.cordis.yml. Чтобы переопределить пресет, доверенный системой, необходимо сначала передать base, чтобы скопировать его в корень пользователя (предотвращая случайное затенение встроенного пресета с нуля). Механизм временных меток standing mount автоматически применяет изменения к новым сессиям без перезапуска; текущие сессии не затрагиваются.

• Аудит: каждая запись/удаление добавляет строку JSONL (время, инструмент, цель, действие, количество байт, сводка первых 200 символов содержимого), обрезается по auditLimit.

Related MCP server: dsh-trio

Установка

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

Затем настройте токен в ~/.dsh/profiles/web/cordis.patch.yml профиля (обязательно, иначе плагин откажется запускаться):

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

Конфигурация

Конфигурация MCP-клиента

Самый простой способ: откройте страницу «Управление MCP» в Settings, сначала в поле «Публичный адрес доступа» укажите публичный/локальный адрес этого развёртывания (например, http://1.2.3.4:3080, обязательно для NAT-машин; если оставить пустым, будет использоваться адрес, с которого вы открыли эту страницу), сохраните, затем нажмите «Скопировать инструкцию по настройке MCP» — будет скопирована полная инструкция (включая URL и токен), которую можно вставить агенту для настройки. Обратите внимание: на страницах http:// браузер запрещает автоматическое копирование, кнопка деградирует до отображения текстового поля для ручного копирования.

Формат ручной настройки (тип Streamable HTTP):

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

Список инструментов

Замечания по безопасности

• Веб-сервер harness'а сам по себе не имеет TLS и аутентификации; /mcp находится за пределами доверенного периметра /api, token — единственная линия защиты. Утечка токена означает, что злоумышленник может перезаписать ваши навыки и пресеты (косвенное удалённое выполнение кода).

• Рекомендуется раскрывать только после завершения TLS на обратном прокси, или использовать механизм trusted-host harness'а для ограничения источников.

• Все операции записи ограничены корнем пользователя (~/.dsh/skills, ~/.dsh/.agent-presets), не затрагивают встроенные пресеты и каталоги проектов.

• RPC-канал панели (/mcp-admin) проходит через периметр trusted-host соединения; записи аудита не содержат секретов.

• Кнопка «Скопировать инструкцию по настройке MCP» передаёт токен на страницу через endpoint setup-info: любой, кто может открыть Web UI, может получить токен. Это согласуется с существующей моделью безопасности harness'а (открыв Web UI, уже можно запускать агента на сервере через session.prompt), но означает, что поверхность Web UI = поверхность токена.

Разработка

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

Разрешение типов в client-половине зависит от локального дерева исходников harness'а (dsh-client-* не полностью опубликован в npm), paths в tsconfig*.json жёстко указывают на checkout harness'а; при переносе на другую машину эти пути нужно изменить.