@dawn0608/dsh-mcp-manager 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dawn0608
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# MCP Management
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[中文](README.zh.md) | English
+
+In DeepSeek Harness, open **Settings → MCP Management** to see the servers configured in the current profile's user patch. Each row shows the server name, transport (STDIO or Streamable HTTP), and whether the server is enabled.
+
+## Manage servers
+
+- Use the switch on an editable row to enable or disable the server. The switch updates the row's `disabled` setting, and Harness hot reloads the change.
+- Add, edit, or remove servers in the profile's `cordis.patch.yml`. You can give your assistant the provider's setup instructions and ask it to edit that file. The panel refreshes while it is open.
+- Rows outside a top-level `insert` list, with missing or duplicate IDs, with conditional `disabled` values, or with another unsupported shape are read-only. The panel also flags duplicate server names.
+
+## Credentials
+
+Store sensitive MCP values (env values, header values) with the Loader `!!js` reference Harness supports instead of plaintext:
+
+```yaml
+env:
+  MCP_TOKEN: !!js 'process.env.MCP_TOKEN'
+headers:
+  Authorization: !!js '`Bearer ${process.env.MCP_TOKEN}`'
+```
+
+References resolve against the Harness process environment.
+
+## Install
+
+Requires DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`.
+
+In Desktop, open **Plugins → Add plugin** and enter `@dawn0608/dsh-mcp-manager`. For a CLI-managed profile, run:
+
+```bash
+dsh plugin --profile <profile> add @dawn0608/dsh-mcp-manager
+```
+
+You can also download the `.tgz` from [GitHub Releases](https://github.com/dawn0608/dsh-plugins/releases?q=mcp-manager) and install it with `dsh plugin --profile <profile> add /path/to/package.tgz`. Fully quit Harness Desktop before using the CLI to manage its profile.
+
+To install from source, build from the repository root:
+
+```bash
+npm ci
+npm run build --workspace @dawn0608/dsh-mcp-manager
+```
+
+Then select the local `plugins/mcp-manager` directory in the plugin picker. If an older installation is present, remove it before switching installation sources. Open **Settings → MCP Management** after installation and restart Harness if prompted.
+
+## Configuration
+
+The plugin has no required configuration. Optional:
+
+```yaml
+- id: mcp-manager
+  name: '@dawn0608/dsh-mcp-manager'
+  config:
+    patchPath: /absolute/path/to/cordis.patch.yml
+```
+
+Use `patchPath` only for a non-standard profile layout; the default derives from `DSH_PROFILE_DIR`.
+
+## Limitations
+
+The panel manages the current profile's user patch. Bundle-provided services, other profiles, and the Codex and Claude Code configurations are managed separately.
+
+## Development
+
+```bash
+npm test          # builds first; covers patch editing, validation, references, locking and atomic writes, and the state API
+npm run verify    # from the repository root
+```
+
+The host bundle includes the ISC-licensed `yaml` dependency. [Upstream license](https://github.com/eemeli/yaml/blob/main/LICENSE)
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,75 @@
+# MCP 管理
+
+[English](README.md) | 中文
+
+在 DeepSeek Harness 打开「设置 → MCP 管理」，查看当前 profile 用户补丁中的 MCP 服务。每行显示服务名、传输方式（STDIO 或 Streamable HTTP）和启用状态。
+
+## 管理服务
+
+- 用可编辑条目上的开关启停服务。开关更新条目的 `disabled` 设置，Harness 会热加载变更。
+- 在当前 profile 的 `cordis.patch.yml` 中添加、编辑或删除服务。也可把服务提供方的安装说明交给 AI，请它修改该文件。面板打开时会自动刷新。
+- 顶层 `insert` 列表之外的条目、缺少 ID 或 ID 重复的条目、使用条件式 `disabled` 的条目，以及其他无法安全修改的条目均为只读。面板也会标出同名服务。
+
+## 凭据
+
+MCP 配置里的敏感值（env 值、请求头值）建议使用 Harness 支持的 Loader `!!js` 引用，而不是写入明文：
+
+```yaml
+env:
+  MCP_TOKEN: !!js 'process.env.MCP_TOKEN'
+headers:
+  Authorization: !!js '`Bearer ${process.env.MCP_TOKEN}`'
+```
+
+引用值由 Harness 进程环境提供。
+
+## 安装
+
+适用于 DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`。
+
+在 Desktop 打开「插件 → 添加插件」，输入 `@dawn0608/dsh-mcp-manager`。通过 CLI 管理 profile 时，可运行以下命令。
+
+```bash
+dsh plugin --profile <profile> add @dawn0608/dsh-mcp-manager
+```
+
+也可从 [GitHub Releases](https://github.com/dawn0608/dsh-plugins/releases?q=mcp-manager) 下载 `.tgz`，再运行 `dsh plugin --profile <profile> add /path/to/package.tgz` 安装。用 CLI 管理 desktop profile 前请完全退出 Harness Desktop。
+
+从源码安装时，在仓库根目录构建。
+
+```bash
+npm ci
+npm run build --workspace @dawn0608/dsh-mcp-manager
+```
+
+构建完成后，通过本地包入口选择 `plugins/mcp-manager`。切换安装来源时，先移除已有安装。安装后打开「设置 → MCP 管理」，按应用提示重启。
+
+## 配置
+
+插件自身没有必填配置。可选：
+
+```yaml
+- id: mcp-manager
+  name: '@dawn0608/dsh-mcp-manager'
+  config:
+    patchPath: /absolute/path/to/cordis.patch.yml
+```
+
+`patchPath` 只应在非标准 profile 布局下使用；默认从 `DSH_PROFILE_DIR` 推导。
+
+## 限制
+
+面板管理当前 profile 的用户补丁。bundle 自带服务、其他 profile 以及 Codex 和 Claude Code 的配置各自独立管理。
+
+## 开发
+
+```bash
+npm test          # 含构建；单元测试覆盖补丁编辑、校验、引用、锁与原子写、状态接口
+npm run verify    # 仓库根目录
+```
+
+Host 构建产物内联了采用 ISC 许可证的 `yaml` 依赖。[上游许可证](https://github.com/eemeli/yaml/blob/main/LICENSE)
+
+## 许可证
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: mcp-manager
+      name: '@dawn0608/dsh-mcp-manager'

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 36 36" width="36" height="36">
+  <path d="M15 9v4m6-4v4M13 13h10v2a5 5 0 0 1-10 0zM18 20v4m-8 2v-2h16v2"
+        fill="none" stroke="#527ee8" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="10" cy="26" r="2" fill="#527ee8"/>
+  <circle cx="26" cy="26" r="2" fill="#527ee8"/>
+</svg>