dsh-mcp-tool
Manifest validFolder-scoped MCP server governance: one global server registry, per-folder presets that decide which servers are allowed, and on-demand start/stop for the servers it owns (mcp_load / mcp_release, idl
dsh-mcp-tool
MCP-серверы, которые включаются пресетом рабочей папки.
Реестр серверов заводится глобально и ни один из них не запущен. Пресет говорит,
какие серверы включены; рабочая папка получает пресет. Включённый сервер агент
поднимает сам, когда он ему понадобился (mcp_load), и останавливает, когда перестал
быть нужен (mcp_release). Процесс также завершается сам по простою. Сервер со способом
загрузки «всегда запущен» стартует вместе с плагином везде, где он включён, и не
выгружается по простою.
Устройство плагина, сущности и жизненный цикл — docs/DESIGN.md.
Что видит агент
mcp_servers— какие серверы включены в его папке, их статус, способ загрузки и число инструментов (для остановленного сервера — по сохранённому каталогу, без запуска процесса).mcp_load { server }— поднять сервер; возвращает имена и входные схемы инструментов. Инструменты появляются какmcp__<server>__<tool>со следующего шага модели.mcp_release { server }— отпустить сервер; при нулевом счётчике процесс завершается (для «всегда запущенного» сервера процесс остаётся).
Все три инструмента скрыты в папках, где ничего не включено. Плюс секция системного промпта с той же картиной. Если сервер выключен пресетом, но его инструмент уже попал в список модели, вызов всё равно будет отклонён с подсказкой включить сервер в настройках.
Что видит человек
- Настройки → MCP Tool — страница плагина:
- MCP — реестр серверов (stdio и streamable-http), добавление и правка формой прямо на странице: «Изменить» разворачивает поля внутри карточки сервера, у каждого сервера способ загрузки: «Ленивая загрузка» или «Всегда запущен»;
- Пресеты —
default(действует во всех папках без своего пресета) и именованные пресеты; плашка пресета разворачивается в список серверов с переключателем Вкл / Выкл / Наследовать, где «Наследовать» берёт значение изdefault; - Рабочие папки — все workspace'ы DSH и папки с назначенным пресетом; выбор пресета для папки.
- Чип в строке ввода —
MCP · <пресет>рядом с полем ввода: быстрый выбор пресета для папки открытого диалога. Показ чипа включается и выключается на странице настроек. - Серверы из настроек DSH. Серверы, добавленные в
Настройки → MCPсамого DSH, подхватываются автоматически при открытии страницы плагина: появляются в реестре с пометкой «из настроек», выключенными вdefault, и не редактируются здесь — их правят в настройках DSH. Удалённые из настроек исчезают из реестра вместе со строками в пресетах. Пресет решает, какие их инструменты видит агент в этой папке. Если сервер в настройках выключен, плагин поднимает его по требованию (mcp_loadили кнопка «Запустить по требованию») и гасит поmcp_releaseили после 10 минут простоя; сервер, поднятый самим DSH, плагин не останавливает. Способ управления выбирается в шапке страницы сегментами «Авто | Тумблер | Свой процесс», под ними подпись, объясняющая выбранный режим (по умолчанию — «Авто»):- Тумблер — плагин переключает
enabledзаписи в настройках DSH и ждёт, пока менеджер поднимет или погасит процесс: владелец сервера остаётся штатный; - Свой процесс — плагин поднимает собственное соединение в изолированном scope и не трогает запись в настройках: на время работы она гасится, а при остановке включается обратно, если была включена; инструменты проецируются агентам с учётом пресета;
- Авто — по серверу: гасит и поднимает через менеджер то, что в настройках выключено, и монтирует своё соединение для включённого (его имя занято в корневом scope).
- Тумблер — плагин переключает
- Кнопки и переключатели страницы повторяют нативную малую кнопку оболочки: та же высота, шрифт, радиус и волосяная обводка; заливка — только у «действенных» кнопок.
- Интерфейс на русском и английском.
Установка
Плагин — обычный DSH-bundle:
dsh plugin --profile <profile> add <path-to-this-repo>
Например, при клоне в D:\Projects\dsh-mcp-tool:
dsh plugin --profile desktop add D:\Projects\dsh-mcp-tool
Профиль для разработки: mcp-tool-dev (--from-default-profile web).
Хранение
Один файл $DSH_HOME/storages/mcp_tool.json (общий для всех профилей): серверы,
пресеты, назначения папок и глобальная настройка чипа. Живое состояние (процессы,
счётчики) не сохраняется. Записи, зеркалированные из настроек DSH, помечены
origin: "profile".
Доступ к маршрутам
Страница плагина общается с хостом по своим роутам /dsh-mcp-tool/*. Каждый запрос
сначала проходит штатную проверку DSH — ctx.connection.requestRejection(req): без
браузерного токена 401, при чужом Host/Origin 403, в обоих случаях реестр не
трогается. Мутации дополнительно требуют заголовок x-dsh-mcp-tool: 1 и
content-type: application/json, поэтому кросс-сайтовая форма не может
зарегистрировать сервер.
Разработка
node .\node_modules\typescript\bin\tsc -p tsconfig.json # хост
node .\node_modules\typescript\bin\tsc -p tsconfig.client.json # клиент (ESM)
node scripts\wrap-client.mjs # обёртка в window.__ModuleLoader__
node --test --test-isolation=none "test/*.test.mjs" # тесты
npm install в этом окружении — только с кэшем внутри проекта:
npm install --cache .npm-cache.
Диагностика: MCPTOOL_DEBUG=1, запись в файл — MCPTOOL_LOG=<путь>.
Приёмка на реальном сервере
set MCPTOOL_ACCEPT_COMMAND=C:\tools\my-server.exe
set MCPTOOL_ACCEPT_ARGS=--mcp
node test\accept-stdio.mjs
Скрипт копирует сервер во временный каталог, поднимает его по stdio, проверяет
tools/list, при желании один вызов инструмента и завершение процесса после закрытия
клиента. Настройка — переменными окружения:
| переменная | смысл |
|---|---|
MCPTOOL_ACCEPT_COMMAND | исполняемый файл сервера (обязательно) |
MCPTOOL_ACCEPT_ARGS | аргументы через пробел, по умолчанию --mcp |
MCPTOOL_ACCEPT_COPY | дополнительные файлы рядом с сервером, через ; |
MCPTOOL_ACCEPT_EXPECT_TOOLS | ожидаемое число инструментов |
MCPTOOL_ACCEPT_TOOL | инструмент для проверочного вызова |
MCPTOOL_ACCEPT_TOOL_ARGS | JSON с аргументами этого вызова |
Запускайте на копии сервера и в офлайн-режиме, если он умеет: скрипт не должен трогать живые данные.
Лицензия
MIT — см. LICENSE.
Comments
Loading…
Similar plugins
by whiteS18
MCP server management panel in Settings: add, edit, enable/disable and delete servers across user and workspace scopes with form or JSON editing, and auto-register discovered MCP tools as native conve
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-mcp-servers-panelby hlyyh21201-prog
DSH plugin: manage MCP servers from the Web settings panel (list, start/stop, edit, probe by real handshake) and import configs from Codex TOML, mcpServers JSON and VS Code mcp.json.
★ 0
MIT
JavaScript
Oct 16, 2026
dsh plugin --profile web add @yyh/dsh-mcp-hubMCP 全局管理:扫描已知工具的 MCP 配置(28 个内置源与自定义源),一键刷新同步差异,双向导入/写回,并在 DSH 侧栏直接增删改 MCP 服务器。
★ 0
dsh plugin --profile web add dsh-mcp-global-managerby shiliu153
DeepSeek Harness bundle: manage MCP servers — list, probe, add from pasted project references, toggle, remove, rotate credentials. Official dsh-mcp-client contract compliant.
★ 0
NOASSERTION
JavaScript
Nov 2, 2026
dsh plugin --profile web add @dsh-contrib/dsh-mcp-managerby appthin
MCP management page in DSH Settings: list, enable/disable, restart and delete MCP servers, edit them in form or JSON mode, expand a server to see the tools it registers, and paste-import MCP configs f
★ 30
↓ 1.1k/wk
MIT
JavaScript
Nov 11, 2026
dsh plugin --profile web add dsh-mcp-manager-plusby fanyongbing
MCP server manager for DeepSeek Harness — manage this machine's MCP servers as native Loader rows, from a Settings page with cards, search, start/stop and a full config editor. · DSH 本机 MCP 管理器:把 MCP 服务器当原生 Loader 行管理,设置页卡片列表 + 搜索 + 启动/停用 + 配置编辑。
★ 0
MIT
JavaScript
Sep 30, 2026
dsh plugin --profile web add dsh-mcp-native