MCP 工作室 mfallah/dsh-mcp-studio

MCP 工作室，为 DeepSeek Harness 而生

直接在 Harness 里查看、安装、连接和管理 MCP 服务器 —— 不用碰 YAML。

@mfallah/dsh-mcp-studio 是 DeepSeek Harness 插件，给 Web 界面加了一个波斯语、从右到左的面板。
不用再为每台服务器在 cordis.patch.yml 里写一段 insert，你从目录里挑，填好表单，测一下连接，然后安装。服务器定义存在插件自己的仓库里，所以你的配置档层保持原样。

MCP 工作室面板示意图

上图是示意图，不是真实截图。想换成真实截图，把你的文件放进 docs/assets/，再把这一行图片指向它。

快速安装（60 秒）

前置条件：Node.js 22 或更高版本，以及一个 dsh 能识别到的 Harness 配置档。

cd F:\harness\dsh-mcp-studio

۱) پیشنمایش: فقط میگوید چه کاری انجام میشود، هیچ فایلی را تغییر نمیدهد
powershell -ExecutionPolicy Bypass -File .\install.ps1 -DryRun

۲) نصب
powershell -ExecutionPolicy Bypass -File .\install.ps1

۳) Harness را دوباره اجرا کن
dsh web

然后打开 <http://127.0.0.1:3080>，点侧边栏里的 MCP 工作室 图标。

如果你用 Git-Bash、WSL 或 macOS/Linux，等价命令是：

bash install.sh --dry-run # پیشنمایش
bash install.sh # نصب

不想用安装脚本，手动安装的等价做法：
dsh plugin --profile web add F:\harness\dsh-mcp-studio
یا مستقیم از مخزن، بدون هیچ گام ساختی:
dsh plugin --profile web add github:mfallah/dsh-mcp-studio

这一条命令就够了；包会从 package.json → dsh.bundle.patch 带上自己的层。
构建产物（lib/）已经提交进仓库，因为 DSH 启动时会读取 lib/client.js 包；所以从 GitHub 安装不需要 pnpm run build。这个包也没有任何运行时依赖。

三大操作系统的完整指南、离线安装和彻底卸载：docs/INSTALL.md。

功能

| 功能 | 做什么 |
| 目录 | 插件自带 34 台服务器，离线可用，另外还能搜索 MCP 官方注册表 |
| 表单安装 | 每台服务器的输入项以表单展示；敏感输入项存进密钥仓库，而不是写进文件 |
| 连接测试 | 保存前先真实连一次，显示发现的工具、协议版本和耗时 |
| 两种传输方式 | stdio（本地进程：npx、uvx、docker……）和 streamable-http |
| 实时管理 | 开关、重启、编辑、删除任意服务器，不用重启 Harness |
| 工具与日志 | 列出每台服务器的工具，命名空间为 mcp__<نام>__<ابزار>，并显示该服务器的实时日志 |
| 运行环境检测 | 检查系统上是否有 node、npx、npm、pnpm、bunx、uvx、python 和 docker |
| 密钥管理 | 配置中用 ${secret:NAME} 引用值，绝不发送到浏览器 |
| 导出补丁 | 把全部状态导出为一个 cordis.patch.yml 块，方便你搁置插件 |
| 波斯语与 RTL | 插件自己注册「波斯语」语言包；面板支持双语，文本方向取自 Harness 当前启用的语言 |
| Harness 主题 | 颜色取自 Harness 自身的 --dsw- token，所以面板会跟随 Appearance 设置（浅色/深色）保持一致 |

安全：你的电脑上会运行什么

- 插件本身在 Harness 同一个进程里运行；不启动独立服务，也不开放端口。
- 每个启用的服务器都是一个子进程，由官方插件 @deepseek-ai/dsh-mcp-client 启动。
进程环境由 Harness 清理过的环境加上你自己设定的变量组成。
也就是说，你安装的任何服务器，都拥有 Harness 进程同样的权限。
- 密钥保存在 $DSH_HOME/mcp-studio/secrets.json，权限为 0600，在 Windows 上则用 ACL 限制为当前用户。密钥的值绝不会出现在 servers.json、日志、事件或 HTTP 响应里；只有密钥的名字会传递。
- 服务器文件是 $DSH_HOME/mcp-studio/servers.json，可以包含 ${env:NAME} 和 ${secret:NAME}。
- 本地接口挂在 /mcp-studio-api 路径上；只接受 loopback 请求，强制要求 x-mcp-studio: 1 请求头，并拒绝跨域请求。
- 彻底删除：install.ps1 -Uninstall 会把插件从配置档中移除。要清掉数据，再删除 $DSH_HOME/mcp-studio 文件夹（这个文件夹保存服务器、密钥和备份版本）。

工作原理

┌─────────────────── DeepSeek Harness (یک فرایند) ────────────────────────────────┐
│ │
│ مرورگر http://127.0.0.1:3080 میزبان (Node.js) │
│ ┌─────────────────────────────┐ ┌───────────────────────────┐ │
│ │ پنل استودیوی MCP │ POST │ @mfallah/dsh-mcp-studio │ │
│ │ ├ کاتالوگ │ /mcp-studio- │ ├ سرویس (RPC) │ │
│ │ ├ نصبشدهها │ api/rpc │ ├ servers.json │ │
│ │ ├ فرم افزودن/ویرایش │ ──────────────▶ │ └ secrets.json │ │
│ │ └ ابزارها + لاگ │ ◀────────────── │ │ mount │ │
│ └─────────────────────────────┘ JSON │ ┌─────────▼─────────────┐ │
│ │ │ dsh-mcp-client × N │ │
│ │ └─────────┬───────────┘ │
│ └────────────┼──────────────┘
└────────────────────────────────────────────────────────────────┼───────────────┘
│ stdio / HTTP
▼
MCP 服务器（npx、uvx、docker、…）

架构上有一点很关键：插件从不写 cordis.patch.yml。服务器定义留在插件自己的仓库里，宿主服务为每个启用的服务器挂载一个 dsh-mcp-client 实例；正因如此，增删服务器都不需要重启。

文档

- 安装与卸载 — Windows、macOS、Linux、离线安装、彻底卸载
- 使用指南 — 浏览面板、添加服务器、密钥、日志
- 故障排查 — 常见错误与已知限制
- 更新日志

许可证

MIT — LICENSE

English (short)

MCP Studio is a DeepSeek Harness plugin that adds a visual, Persian-first (RTL) panel to the harness
web GUI: browse a catalog of MCP servers, install and connect them through a form, test the connection
before saving, and watch each server's tools and logs. The panel paints from the harness's own --dsw-
theme tokens, so it follows the active Appearance setting (light or dark). Server definitions live in the
plugin's own store ($DSH_HOME/mcp-studio/), so your profile's cordis.patch.yml stays yours and no
restart is needed to add or remove a server.

Install (Windows / PowerShell):

cd F:\harness\dsh-mcp-studio
powershell -ExecutionPolicy Bypass -File .\install.ps1 -DryRun # preview, changes nothing
powershell -ExecutionPolicy Bypass -File .\install.ps1 # install
dsh web # restart, then open http://127.0.0.1:3080

Install (Git-Bash / WSL / macOS / Linux): bash install.sh --dry-run, then bash install.sh.

Manual install: dsh plugin --profile web add <path-or-package> — the package declares dsh.bundle.patch, so the plugin activates itself. The built output (lib/) is committed, so a git-URL
install (dsh plugin --profile web add github:mfallah/dsh-mcp-studio) needs no build step; run
pnpm run build only after changing src/. The package has no runtime npm dependencies — its three peers come from the harness.

Security: secrets are stored in $DSH_HOME/mcp-studio/secrets.json (mode 0600; ACL tightened on
Windows) and never cross the browser boundary — only secret names do. The panel talks to the host over a loopback-only /mcp-studio-api route that requires the x-mcp-studio: 1 header and rejects cross-origin requests. Each enabled server runs as a child process with the harness's scrubbed environment plus the variables you set, so install only servers you trust.

Remove everything: install.ps1 -Uninstall, then delete $DSH_HOME/mcp-studio.

Full documentation is Persian-first; see docs/INSTALL.md,
docs/USAGE.md and docs/TROUBLESHOOTING.md.