dsh-plugin-mcp-manager
Управление подключениями MCP (Model Context Protocol) в DeepSeek Harness: страница Настройки → MCP и инструмент агента mcp_connections.
MCP connections manager for DeepSeek Harness: a Settings → MCP page plus an mcp_connections agent tool, both backed by one operation set.
- Web-страница в стиле штатных настроек (ru/en), живой статус соединений;
- добавление, редактирование, удаление, включение и отключение серверов без перезапуска приложения;
- транспорты Streamable HTTP (
url,headers) и stdio (command,args,env,cwd); - кнопка Проверить — разовое подключение черновика с выводом списка инструментов;
- инструменты сервера доступны агенту как
mcp__<serverName>__<tool>; MCP-ресурсы — черезlist_mcp_resources; - тот же набор операций доступен агенту инструментом
mcp_connections.
Установка
В приложении: Настройки → Плагины → Установить (репозиторий или локальная папка).
Или из GitHub:
dsh plugin --profile <profile> add github:zznobzz/dsh-plugin-mcp-manager
или через plugin_manager в агенте:
install_bundle target: github:zznobzz/dsh-plugin-mcp-manager
Локальная разработка: скопируйте каталог и поставьте его как локальный бандл
(install_bundle target: <абсолютный путь>); при установке из локальной папки плагин
подключается ссылкой, изменения хост-части применяются после перезапуска плагина
(выключить/включить строку в Настройки → Плагины), клиентской — после обновления страницы.
Использование
Через настройки
Настройки → MCP → Добавить сервер:
| Поле | Значение |
|---|---|
| Имя сервера | префикс инструментов, ^[A-Za-z0-9_-]{1,32}$, уникальный |
| Транспорт | Streamable HTTP — url + необязательные headers; STDIO — command + args, env, cwd |
| Таймаут вызова | мс, по умолчанию 60000 |
Строка в списке показывает статус (Подключено, Подключение…, Ошибка, Отключено),
число инструментов и текст ошибки; кнопки «Проверить», «Изменить», «Удалить» и переключатель.
Через агента
mcp_connections action=list
mcp_connections action=add server={serverName:"demo", transport:"stdio",
command:"npx", args:["-y","@modelcontextprotocol/server-everything"]}
mcp_connections action=test server={serverName:"probe", transport:"streamable-http",
url:"https://example.com/mcp"}
mcp_connections action=disable id=<id>
mcp_connections action=remove id=<id>
Внешние подключения (настроенные до установки плагина)
Если MCP-серверы уже были подключены в профиле — строкой @deepseek-ai/dsh-mcp-client
в cordis.patch.yml или в установленном бандле, — плагин находит их сам и показывает
отдельным блоком «Настроены вне плагина»:
- имя, транспорт, цель, живой статус и список инструментов — как у обычных подключений;
- переключатель включения/отключения сохраняется штатным Plugin Manager (строка остаётся в своей конфигурации);
- редактировать и удалять такие строки плагин не даёт — их владелец это профиль/бандл;
в UI и в
listони помечены какexternal; - повторный
serverNameотклоняется: подключать тот же сервер ещё раз через плагин нельзя, иначе имена инструментовmcp__<serverName>__*конфликтуют.
Через агента: mcp_connections action=disable id=include:<row-id> (id строки виден в list).
Импорт из Cursor / Claude Desktop / VS Code
Если MCP-серверы уже настроены в другом клиенте, плагин умеет их скопировать к себе:
кнопка «Импортировать…» на странице MCP (или mcp_connections action=importScan /
action=import у агента).
Читаются только известные пользовательские файлы, без записи в них:
| Источник | Файл | Ключ |
|---|---|---|
| Cursor | ~/.cursor/mcp.json |
mcpServers |
| Claude Desktop | %APPDATA%\Claude\claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/…) |
mcpServers |
| VS Code | %APPDATA%\Code\User\mcp.json (~/.config/Code/User/mcp.json на Linux) |
servers |
Особенности:
- конфиги Cursor/VS Code часто в формате JSONC — комментарии и висячие запятые допускаются;
url→ транспорт Streamable HTTP (headersпереносятся),command/args/env→ stdio;timeout→ таймаут вызова инструмента;- имена из конфига нормализуются под
^[A-Za-z0-9_-]{1,32}$(например,io.github.upstash/context7→io_github_upstash_context7), конфликты получают суффикс; - в предпросмотре цели показаны без секретов (для stdio — команда и число аргументов);
после импорта
args/env/headersсохраняются в файл плагина как есть — те же, что были в исходном конфиге, включая секреты.
Хранение
Определения подключений: $DSH_HOME/plugins/mcp-manager/servers.json
(создаётся с правами 0600). Файл читается при старте профиля и переписывается
каждым изменением из UI или инструмента. Секреты в env/headers лежат в этом файле
и не маскируются в интерфейсе.
Как устроено
- Host (
index.js): хранит список, монтирует по одному экземпляру@deepseek-ai/dsh-mcp-clientна включённый сервер черезctx.plugin(), собирает статусы и имена инструментов, отдаёт REST-подобные эндпоинты/api/mcp-manager.list|save|remove|setEnabled|setExternalEnabled|importScan|import|testна общем каналеconnection.fetchи регистрирует инструментmcp_connections. Строки@deepseek-ai/dsh-mcp-client, настроенные вне плагина, читаются через сервисыconfigEditor(конфигурация) иpluginManager(включённость, состояние, диагностика) и не монтируются повторно. - Client (
client.js): регистрируется в слотыsettings.section(idmcp) иsettings.section.icon, вызывает хостовые эндпоинты черезctx.connection.rpc.call. - Модуль
@deepseek-ai/dsh-mcp-clientрезолвится динамическим импортом: сначала по имени пакета, затем по путям установки DSH (resources/app.asar/dsh/node_modules/..., распакованные и CLI-варианты) — см.mcpClientCandidates()вindex.js.
Проверка
В репозитории лежит test/mcp-demo-server.mjs — минимальный локальный MCP-сервер
(stdio, инструмент echo). Он не входит в устанавливаемый пакет (см. files):
node test/mcp-demo-server.mjs
Сценарий: добавить подключение (stdio, command — путь к node, args — путь к этому файлу),
дождаться статуса Подключено, убедиться, что агент видит mcp__<serverName>__echo,
выключить сервер и проверить, что инструмент исчез.
Ограничения
- Одно подключение = один
serverName; имена инструментов глобальны для профиля. - Значения
env/headersхранятся в открытом виде в файле определений. - Плагин не расширяет права сервера MCP: он только запускает штатный клиент и показывает его состояние.
- Блок «Настроены вне плагина» работает при доступных сервисах
configEditorиpluginManager(обычный web/desktop профиль). Без них внешние строки не обнаруживаются, а управляемые подключения плагина продолжают работать.
Лицензия
MIT — см. LICENSE.
No comments yet. Be the first to write one.