# MCP Toggles для DeepSeek Harness

Компактные переключатели MCP-серверов в **Settings → Built-in plugins → MCP**.

[English](README.md) · [Лицензия](LICENSE) · [Безопасность и приватность](SECURITY.md)

## Возможности

- Показывает MCP-плагины, уже настроенные в текущем профиле Harness.
- Включает и выключает их через встроенный Plugin Manager.
- Сохраняет изменения в `cordis.patch.yml` профиля через штатный Loader.
- Предоставляет тумблеры, кнопку обновления, счётчик и состояния сохранения/ошибки.
- Поддерживает тему Harness, управление клавиатурой, уменьшение анимации, русский и английский интерфейс.

Плагин **не устанавливает MCP-серверы**, не добавляет их конфигурацию, не запрашивает секреты и не меняет команды запуска.

## Требования

Нужна версия DeepSeek Harness, в которой доступны слот `settings.plugins.tab`, клиентские сервисы локали, UI slots и API remotes, а также Host-методы `pluginManager.listPlugins()` и `pluginManager.setPluginEnabled()` для вызова из клиента.

Список ограничен MCP-плагинами пакета `@deepseek-ai/dsh-mcp-client`. Другие реализации MCP не отображаются. Минимальная версия Harness не установлена; совместимость зависит от наличия перечисленных API. Проверка на всех версиях и платформах не проводилась.

## Установка

Сборка, установка зависимостей и отдельный веб-сервер не нужны.

1. Клонируйте репозиторий в постоянную папку:

   ```sh
   git clone https://github.com/funk80rus/dsh-mcp-toggles.git
   ```

2. Откройте нужный профиль Harness и попросите ассистента:

   > Установи локальный Cordis bundle из моей папки dsh-mcp-toggles через plugin_manager install_bundle. Если нужен абсолютный путь к папке, спроси его.

   Используется инструмент `plugin_manager`: `action: "install_bundle"`, `target` — **абсолютный путь к клонированной папке**. Проверьте и подтвердите запрос установки. Не копируйте патч в профиль вручную и не редактируйте манифест профиля.

3. Если Harness потребует перезапуск, выполните его, затем обновите страницу. Откройте **Settings → Built-in plugins → MCP**. В некоторых версиях раздел называется **Plugins**.

Локальная установка создаёт ссылку на папку проекта. Не удаляйте и не перемещайте её, пока bundle установлен. Поле `private: true` защищает от случайной публикации в npm, но не мешает локальной установке.

## Использование

Переключите тумблер. После изменения плагин повторно читает состояние из Host. Кнопка обновления перечитывает список, а не перезапускает все серверы.

Изменения относятся ко **всему текущему профилю**, а не к отдельному проекту или разговору. Выключение сервера может прервать работу инструментов в других сессиях этого профиля. Включение может запустить команду, уже указанную в настройках MCP-сервера: включайте только доверенные серверы.

Тумблер означает **настройку включения плагина**, а не проверенное соединение с MCP-сервером. Изменение применяется через Loader; при необходимости перезапуска, перекрытии другим патчем или ошибке показывается результат Host. Строки с запретом изменения недоступны для переключения.

## Обновление и удаление

Для обновления выполните `git pull --ff-only` в папке проекта. При необходимости перезапустите Harness для загрузки нового модуля, затем обновите страницу браузера.

Для удаления попросите Harness вывести установленные bundles и удалить `dsh-mcp-toggles` через `plugin_manager`. Удаление интерфейса не сбрасывает ранее сохранённые настройки включения MCP-серверов.

## Приватность

В распространяемом пакете нет личного профиля, определений серверов, секретов, путей конкретного компьютера, скриншотов или сохранённых состояний серверов. Сам плагин не добавляет аналитику и самостоятельные внешние сетевые запросы: используется существующий транспорт Harness. Сам Harness и настроенные MCP-серверы могут обращаться к сети.

Список серверов и сообщения об ошибках могут содержать сведения о локальной настройке. Проверяйте и обезличивайте скриншоты, логи и сообщения перед публикацией. Подробности — в [SECURITY.md](SECURITY.md).

## Разработка

Клиент — обычный JavaScript, использующий загрузчик модулей и React из Harness. Host-модуль намеренно пустой. Оригинальная SVG-иконка распространяется под MIT вместе с кодом.

```sh
npm test
```

Нужен Node 18+. Установка зависимостей не требуется. Тесты проверяют синтаксис, ресурсы пакета, соответствие локалей и ограничения безопасной публикации. Они не заменяют проверку установленного интерфейса в Harness.

Перед публикацией проверяйте Git diff и точный состав пакета. Не добавляйте профили, логи, файлы окружения, данные авторизации и необезличенные скриншоты. Изменения желательно оставлять без внешних зависимостей.

## Лицензия

[MIT](LICENSE). Независимый плагин сообщества, не официальный продукт DeepSeek.