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

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,71 @@
-# 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.
+View and toggle MCP servers for the current Desktop profile under **Settings → MCP Management**. The panel supports local `stdio` and remote Streamable HTTP servers.
+
+- Each row shows the server name, transport (STDIO or Streamable HTTP), and enablement switch.
+- Give the provider’s setup instructions to your AI assistant so it can update the profile’s `cordis.patch.yml`. The panel automatically picks up configuration changes while open.
+- The switch updates the selected row’s `disabled` state under the profile writer lock. Harness hot reloads the change, and external synchronizers pick it up on their next poll.
+
+## 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
+
+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 install
+npm run build
+```
+
+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
+
+- Only the current profile's **user patch file** is managed; bundle-provided rows, Codex/Claude configuration, and other profiles are out of scope.
+- Rows must sit in a top-level `insert` list, carry a unique id, and use a boolean `disabled`; entries that cannot be safely toggled are shown as read-only.
+- The list flags duplicate names in the same file.
+- Rows using `!!js`, `headers`, or a non-portable environment are skipped by the three-end synchronizer by design: credentials stay local.
+- `yaml` is used at build time and inlined into `lib/index.js`, so the runtime has no extra dependency; see the upstream `eemeli/yaml` repository for its ISC license.
+
+## 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
+```
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,71 @@
+# MCP 管理
+
+在 DeepSeek Harness「设置 → MCP 管理」中查看当前 Desktop profile 的 MCP 服务，并启用或停用服务。
+
+- 每行显示服务名、传输方式（STDIO 或 Streamable HTTP）和启停开关。
+- 可把服务提供方的安装说明交给 AI，让它更新当前 profile 的 `cordis.patch.yml`。面板打开时会自动同步配置变化。
+- 开关通过 profile 写锁和原子写入修改目标条目的 `disabled` 状态。Harness 热加载变更，监听该文件的同步器会在后续轮询时读取它。
+
+## 凭据
+
+MCP 配置里的敏感值（env 值、请求头值）建议使用 Harness 支持的 Loader `!!js` 引用，而不是写入明文：
+
+```yaml
+env:
+  MCP_TOKEN: !!js 'process.env.MCP_TOKEN'
+headers:
+  Authorization: !!js '`Bearer ${process.env.MCP_TOKEN}`'
+```
+
+引用值由 Harness 进程环境提供。
+
+## 安装
+
+在 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 install
+npm run build
+```
+
+构建完成后，通过本地包入口选择 `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 的 **用户 patch 文件**；bundle 自带行、Codex/Claude 配置、其他 profile 不在范围内。
+- 行必须位于顶层 `insert` 列表、id 唯一、`disabled` 为布尔值；无法安全启停的条目显示为只读。
+- 列表会标出同一文件内的重名服务。
+- 带 `!!js`、`headers` 或非可移植环境的条目会被三端同步器标记为 skipped，这是有意为之：凭据留在本机。
+- `yaml` 仅在构建时使用并内联进 `lib/index.js`，运行期没有额外依赖；其 ISC 许可证见上游仓库 `eemeli/yaml`。
+
+## 开发
+
+```bash
+npm test          # 含构建；单元测试覆盖补丁编辑、校验、引用、锁与原子写、状态接口
+npm run verify    # 仓库根目录
+```
+
+## 许可证
+
+MIT

package/cordis.patch.yml

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

package/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect x="4" y="4" width="56" height="56" rx="15" fill="#3f6fe0"/>
+  <path d="M22 23 32 42 42 23" fill="none" stroke="#ffffff" stroke-width="3.2" stroke-linecap="round" stroke-linejoin="round" opacity="0.9"/>
+  <circle cx="22" cy="23" r="5" fill="#ffffff"/>
+  <circle cx="42" cy="23" r="5" fill="#ffffff"/>
+  <circle cx="32" cy="42" r="5" fill="#ffffff"/>
+</svg>