DeepSeek Harness · Plugins

RU · English

---

О проекте

Репозиторий плагинов и MCP-серверов для DeepSeek Harness (DSH). Каждый пакет оформлен по правилам DSH: package.json с секцией dsh.bundle, cordis.patch.yml, документация, тестовый стенд, лицензия.

Комплект решает прикладную задачу: подключить к DSH внешние системы (Sarex, Яндекс.Почта) через MCP-протокол и дать агентам единый, предсказуемый доступ к ним — без ручных скриптов на каждый случай.

Состав

Пакет	Назначение	Стек
dsh-mcp-client	MCP-клиент для DSH: запускает MCP-серверы и регистрирует их инструменты как родные инструменты DSH	Node.js (ESM)
mcp-sarex	MCP-сервер Sarex: Keycloak-авторизация, уведомления, произвольные запросы к API, интерактивный вход с 2FA	Python 3.12
mcp-yandex-mail	MCP-сервер Яндекс.Почты: статус, папки, быстрый поиск по заголовкам, чтение, вложения, отправка	Python 3.12
dsh-approval-remember	Кнопка «Разрешать всегда» в окне подтверждения: правило запоминается и применяется к подобным сценариям	DSH client plugin
dsh-mobile-spike	Минимальный спайк плагина: in-process вход, loopback-маршрут, свой HTTP-листенер и корректный dispose	Node.js
dsh-mobile	Удалённое управление DSH с телефона: LAN-шлюз, pairing, SSE, PWA и in-process мост к сессиям; просмотр не тратит токены. Ранний прототип 0.1.0 — в работе используется одноимённый upstream saya-ch/dsh-mobile 0.6.16, см. docs/ru/dsh-mobile.md	Node.js + PWA
mcp-cua	Computer use для Windows: окна, UIA-дерево, скриншоты, клики и ввод через Cua Driver 0.28.0	Node.js (ESM)
mcp-kot	Мост к агенту Kot в OpenClaw: один ход агента плюс состояние Gateway, каналов, агентов и сессий	Node.js (ESM)
dsh-locale-ru	Русский язык веб-интерфейса: пункт «Русский» в настройках и словари для всех клиентских пакетов, откат ru → en	Node.js (ESM), без сборки
dsh-sync	Двусторонняя синхронизация истории сессий DSH между Windows-установкой и Linux-инстансом: sha256, конвертация cwd в заголовке, push/pull, бэкапы конфликтов. Утилита, а не плагин: cordis.patch.yml не требуется	PowerShell 5.1 + Node.js 22
claude-bridge	Подписка Claude Pro/Max внутри DSH: локальный Anthropic-совместимый мост выполняет запросы через claude CLI — без API-ключа и оплаты по токенам	Node.js (ESM), без зависимостей

Архитектура

flowchart LR
    U[Пользователь] --> DSH[DeepSeek Harness]
    DSH --> P[dsh-mcp-client]
    P -->|stdio JSON-RPC| S1[mcp-sarex]
    P -->|stdio JSON-RPC| S2[mcp-yandex-mail]
    S1 --> KC[Keycloak SSO<br/>realm sarex]
    S1 --> API[Sarex API]
    S2 --> IMAP[IMAP imap.yandex.ru]
    S2 --> SMTP[SMTP smtp.yandex.ru]

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

1. Плагин MCP-клиента

# 1) скопировать пакет в профиль DSH
cp -r packages/dsh-mcp-client ~/.dsh/profiles/desktop/node_modules/dsh-mcp-client

# 2) добавить в профиль: package.json → dsh.profile.bundles, затем перезапустить DSH

В DSH появятся инструменты с префиксами sarex__* и mail__*.

2. MCP-серверы (отдельно от DSH)

python packages/mcp-sarex/server.py            # Sarex MCP (stdio)
python packages/mcp-yandex-mail/server.py      # Яндекс.Почта MCP (stdio)

Подключение в MCP-клиентах — см. README пакета.

Схемы и документация

• Архитектура и схемы · Architecture (EN)
• Правила разработки и публикации — двуязычные
• Глобальное правило публикации · Global rule (EN)
• mcp-cua: управление рабочим столом · mcp-kot: мост к OpenClaw
• dsh-approval-remember: «Разрешать всегда» · dsh-mobile-spike: контракт плагина
• dsh-mobile: что в репозитории и что работает · dsh-mobile (EN)
• dsh-sync: синхронизация истории сессий · dsh-sync (EN)
• claude-bridge: подписка Claude в DSH
• Безопасность и секреты · Security (EN)

Правила

1. Плагины разрабатываются по контракту DSH: package.json → dsh.bundle.patch, cordis.patch.yml, README.
2. Каждый пакет автономен: не тянет зависимости хоста без необходимости, не хранит секреты в коде.
3. Все новые плагины публикуются в этот репозиторий автоматически — без отдельного запроса и подтверждения.
4. Документация — двуязычная (RU/EN), в стиле GitHub: заголовки, таблицы, схемы, примеры команд.
5. Секреты — только в защищённом хранилище (_secrets), не в репозитории.

Безопасность

• Учётные данные читаются из локального защищённого файла, который не коммитится.
• Записывающие операции MCP-инструментов требуют явного confirm=true.
• 2FA Sarex: API-токен выдаётся Keycloak без push-подтверждения; интерактивный вход — с подтверждением на телефоне.

Лицензия

MIT © 2026 rukazax

---

English

Repository of DeepSeek Harness (DSH) plugins and MCP servers. Every package follows DSH conventions: package.json with dsh.bundle, cordis.patch.yml, documentation, test harness, license.

The kit connects DSH to external systems (Sarex, Yandex Mail) through MCP and gives agents a single, predictable access path — no ad-hoc scripts per task.

Package	Purpose	Stack
dsh-mcp-client	MCP client for DSH: spawns MCP servers and registers their tools as native DSH tools	Node.js (ESM)
mcp-sarex	Sarex MCP server: Keycloak auth, notifications, generic API requests, interactive 2FA login	Python 3.12
mcp-yandex-mail	Yandex Mail MCP server: status, folders, fast header search, read, attachments, send	Python 3.12
dsh-approval-remember	«Always allow» button in the approval panel: the rule is remembered and reused for similar scenarios	DSH client plugin
dsh-mobile-spike	Minimal plugin spike: in-process entry, loopback route, own HTTP listener and a clean dispose	Node.js
dsh-mobile	Remote control of DSH from a phone: LAN gateway, pairing, SSE, PWA and an in-process session bridge; viewing costs no tokens. Early prototype 0.1.0 — production uses the same-name upstream saya-ch/dsh-mobile 0.6.16, see docs/en/dsh-mobile.md	Node.js + PWA
mcp-cua	Computer use for Windows: windows, UIA tree, screenshots, clicks and typing through Cua Driver 0.28.0	Node.js (ESM)
mcp-kot	Bridge to the Kot agent in OpenClaw: one agent turn plus Gateway, channel, agent and session state	Node.js (ESM)
dsh-locale-ru	Russian language for the web UI: a «Русский» entry in settings plus dictionaries for every client package, ru → en fallback	Node.js (ESM), no build step
dsh-sync	Two-way sync of DSH session history between a Windows install and a Linux instance: sha256, header cwd conversion, push/pull, conflict backups. A utility, not a plugin: no cordis.patch.yml needed	PowerShell 5.1 + Node.js 22
claude-bridge	A Claude Pro/Max subscription inside DSH: a loopback Anthropic-compatible bridge executes requests through the claude CLI — no API key, no token billing	Node.js (ESM), no dependencies

flowchart LR
    U[User] --> DSH[DeepSeek Harness]
    DSH --> P[dsh-mcp-client]
    P -->|stdio JSON-RPC| S1[mcp-sarex]
    P -->|stdio JSON-RPC| S2[mcp-yandex-mail]
    S1 --> KC[Keycloak SSO]
    S1 --> API[Sarex API]
    S2 --> IMAP[IMAP]
    S2 --> SMTP[SMTP]

Diagrams and documentation

• mcp-cua: desktop control · mcp-kot: OpenClaw bridge
• dsh-approval-remember: Always allow · dsh-mobile-spike: plugin contract
• dsh-mobile: repo vs running setup · dsh-mobile (RU)
• dsh-sync: session history sync · dsh-sync (RU)
• claude-bridge: a Claude subscription in DSH

Quick start

cp -r packages/dsh-mcp-client ~/.dsh/profiles/desktop/node_modules/dsh-mcp-client
# add "dsh-mcp-client" to dsh.profile.bundles in package.json, restart DSH
python packages/mcp-sarex/server.py
python packages/mcp-yandex-mail/server.py

Rules

1. Plugins follow the DSH contract (dsh.bundle.patch, cordis.patch.yml, README).
2. Every package is self-contained and keeps secrets out of code.
3. New plugins are published to this repository automatically, without a separate request or confirmation.
4. Documentation is bilingual (RU/EN) in GitHub style: headings, tables, diagrams, command examples.
5. Secrets live only in the local protected store (_secrets), never in the repository.

Security

• Credentials are read from a local protected file that is never committed.
• MCP write operations require explicit confirm=true.
• Sarex 2FA: the API token is issued by Keycloak without a push prompt; interactive login requires phone approval.

License

MIT © 2026 rukazax