dsh-mcp-server

Предоставляет агента DeepSeek Harness (dsh, кодирующий агент с полным набором инструментов: файлы, терминал, веб-поиск, субагенты, рабочие процессы) в качестве локально доступного модельного бэкенда через Model Context Protocol, а также интерфейсы «пойми меня / измени меня».

┌────────────────────────────┐        stdio / HTTP         ┌──────────────────────────────┐
│  其他 Agent / MCP 客户端     │  ────────────────────────▶  │        dsh-mcp-server         │
│  (Claude Desktop, Cursor,  │                            │  方向A：驱动我（消耗我的额度）  │
│   Claude Code, 自定义程序)   │                            │  方向B：读懂我/改造我（便宜）   │
└────────────────────────────┘                            └──────────────┬───────────────┘
                                                                         │ spawn
                                                              ┌──────────▼───────────────┐
                                                              │  dsh Agent（完整工具链）    │
                                                              │  DeepSeek 模型（默认）      │
                                                              └──────────────────────────┘

Два направления

Направление A: управляй мной — расходует квоту DeepSeek Harness, требуется подтверждение пользователя

Каждый вызов dsh_ask / dsh_converse / dsh_tool запускает полноценный процесс агента dsh, который (с помощью моделей DeepSeek) выполняет реальную работу: читает и пишет файлы, запускает команды, ищет в вебе, отправляет субагентов. Это расходует токенную квоту DeepSeek Harness, поэтому:

1. Вызов сначала возвращает confirmation_required (в этот момент квота не расходуется) и явно сообщает «будет израсходована квота DeepSeek Harness»;

2. Вызывающая сторона обязана показать этот запрос пользователю (MCP-клиенты обычно автоматически показывают вызовы инструментов);

3. После одобрения пользователем вызывается dsh_confirm(requestId, approve=true) — только тогда выполнение действительно происходит; либо dsh_deny(requestId) отменяет запрос.

Каждый ожидающий подтверждения запрос также выводит заметное предупреждение в stderr сервера. Неподтверждённые запросы истекают через 10 минут.

⚠️ Переключатель риска: DSH_MCP_AUTO_APPROVE=1 пропускает шлюз подтверждения (подходит для автономных/полностью доверенных сред). Отдельный вызов также может передать confirm: false для пропуска.

Направление B: пойми меня / измени меня — расходует токены другой стороны, на стороне сервера очень дёшево

Когда другие агенты хотят понять «что я такое, как я спроектирован, как создавать для меня плагины/менять конфигурацию», они используют эти интерфейсы (сервер выполняет только локальное чтение/проверку, не расходуя квоту моделей dsh; модель другой стороны считывает результат в свой контекст, расходуя собственные токены):

Типичное использование: внешний агент сначала читает ресурсы dsh://self/*, чтобы понять дизайн (тратя свои токены), затем вызывает dsh_patch_config для предложения изменений конфигурации (например, смена модели, подключение нового навыка, отключение плагина) или пишет локальный плагин dsh на основе dsh_plugin_contract.

Related MCP server: dsh-orchestrator

Быстрый старт

cd E:\DeepSeek Harness\dsh-mcp
npm install          # 安装 @modelcontextprotocol/sdk

# 冒烟测试：不经过 MCP，直接验证 dsh Agent 后端可用
node scripts/smoke.mjs

# 以 stdio 传输启动服务器（MCP 客户端的标准方式）
node src/index.js

Сервер автоматически обнаруживает локально установленный dsh (сканирует кэш npx / кэш npm / текущий каталог), настройка не требуется. Если не найден, укажите через переменную окружения: DSH_MCP_DSH_BIN=C:\...\@deepseek-ai\dsh\lib\bin.js.

Подключение к Claude Desktop

Отредактируйте %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "dsh": {
      "command": "node",
      "args": ["E:\\DeepSeek Harness\\dsh-mcp\\src\\index.js"]
    }
  }
}

Подключение к Claude Code / Cursor / VS Code

Используйте examples/claude-code.json, examples/cursor-mcp.json, examples/vscode.json соответственно.

Подключение собственного агента (через HTTP)

node src/index.js --transport http --port 3005
# 端点：http://127.0.0.1:3005/mcp  （Streamable HTTP）

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

Переменные окружения

Права и безопасность

• Агент dsh наследует систему прав dsh: по умолчанию workspace-write (запись только в рабочий каталог), можно установить read-only / danger-full-access.

• Все выполнения направления A проходят через шлюз подтверждения, расход квоты раскрывается явно.

• Направление B: пути только для чтения не маскируют значения секретов; путь записи (dsh_patch_config) по умолчанию dry-run, перед записью на диск автоматически создаётся резервная копия, требуется подтверждение, и предупреждается, что слой home влияет на все профили (включая запущенный Web UI).

• Сессии сохраняются в ~/.dsh/sessions, учётные данные общие — ~/.dsh/.credentials.yaml.

• Сервер слушает только локальную машину (канал stdio / 127.0.0.1).

Смена модели (типичное использование направления B)

Модель по умолчанию берётся из agent-default-model dsh (локально deepseek-official / deepseek-v4-flash). Способы изменения:

1. Через dsh_patch_config (рекомендуется): отправьте патч в слой home, после успешной проверки dry-run и подтверждения пользователем он записывается (с автоматической резервной копией). Пример патча:

   - id: agent-default-model
     config:
       provider: deepseek-official
       model: deepseek-chat

2. Изменение глобальных настроек: отредактируйте секцию agent-default-model в ~/.dsh/settings.yaml.

3. Смена целого профиля: DSH_MCP_PROFILE указывает другой профиль (другой набор инструментов/персона).

Известные ограничения

• Каждый вызов направления A — новый процесс (около 2~3 секунд холодного старта + ответ модели), без стриминга, текст задачи ≤ ~30k символов.

• Шлюз подтверждения зависит от того, что вызывающая сторона показывает confirmation_required пользователю; если вызывающая сторона — автономная программа и DSH_MCP_AUTO_APPROVE не задан, запросы будут висеть до истечения.

• Количество ресурсов/инструментов: 6 ресурсов + 11 инструментов.

Разработка и тестирование

node scripts/smoke.mjs              # 仅测 dsh 后端（无 MCP）
node scripts/demo.mjs               # 演示：确认闸门 + 读懂我 + 改配置提议
node scripts/mcp-client-test.mjs    # stdio 端到端：闸门/拒绝/多轮/自省/patch/资源
node scripts/http-client-test.mjs   # HTTP 端到端（自动批准模式）

Структура каталогов

dsh-mcp/
├── src/
│   ├── index.js     # CLI 入口（stdio / HTTP 传输）
│   ├── server.js    # MCP 工具与资源注册
│   ├── dsh.js       # dsh 子进程运行器（spawn/超时/输出捕获/并发闸门）
│   ├── approvals.js # 确认闸门（额度披露、待确认队列、过期）
│   ├── self.js      # 自省：设计快照、技能发现、配置路径、插件契约
│   └── sessions.js  # 会话记忆与多轮提示组装
├── scripts/         # 冒烟 + 演示 + 端到端测试
└── examples/        # 各客户端接入配置