dsh-mcp-servers 1.0.260817

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-mcp-servers contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,74 @@
1
+ # dsh-mcp-servers
2
+
3
+ Expose [Model Context Protocol](https://modelcontextprotocol.io) servers as tools inside [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). A dsh **bundle** with both a server half (connects to MCP servers, registers their tools) and a client half (a settings UI in the web app).
4
+
5
+ ## Features
6
+
7
+ - **stdio, streamable http, and legacy SSE** transports — one shared endpoint field, tabs in the UI
8
+ - **Tools registered automatically** under `<serverId>_<toolName>` (e.g. server id `shadcn` → `shadcn_get_component`)
9
+ - **Live status dots** — green when connected, red with the reason on failure; auto-reconnects with backoff when a connection drops (idle SSE streams, crashed processes)
10
+ - **Test button** per card — probes connect + tool listing against the current draft without registering anything
11
+ - **Edit cards** — type tabs, command/args textarea, env variables (or http headers) as key/value rows with show/hide values, paste `.env` from the clipboard, enabled switch
12
+ - **Tabs**: All / Local / Remote / Backup & Restore
13
+ - **Backup & Restore**: export/import the server list as JSON (with inline preview), and optional **WebDAV sync** (push/pull, https-only, Basic auth) plus an optional **daily automatic backup at 12:00 PM** — password stored server-side as a secret, never sent back to the browser
14
+
15
+ ## Install
16
+
17
+ Requires DeepSeek Harness with the `dsh` CLI.
18
+
19
+ ```sh
20
+ # from a directory containing this repo (or publish it, then use the bare name);
21
+ # <name> is the profile you boot, e.g. `web`
22
+ dsh plugin --profile <name> add ./dsh-mcp-servers
23
+ dsh --profile <name>
24
+ ```
25
+
26
+ Then open Settings → **MCP Servers**, add a server, hit **Test**, and **Save**.
27
+
28
+ Rebuild after changes with `npm run build` — profiles load the built `dist/` and `client/client.js`, not the sources.
29
+
30
+ ## Configuration
31
+
32
+ ### stdio server
33
+
34
+ | field | example |
35
+ | --- | --- |
36
+ | type | `stdio` |
37
+ | command | `npx` |
38
+ | command args | `-y`<br>`@modelcontextprotocol/server-everything` (one per line, first line is the command) |
39
+ | env | key/value rows, e.g. `API_KEY` / your token |
40
+
41
+ ### http / sse server
42
+
43
+ | field | example |
44
+ | --- | --- |
45
+ | type | `http` (streamable) or `sse` (legacy event-stream) |
46
+ | url | `https://example.com/mcp` or `https://example.com/sse` |
47
+ | headers | key/value rows (e.g. `Authorization` / `Bearer …`) |
48
+
49
+ ### Backup & Restore
50
+
51
+ - **Local file**: export the current config (all servers, endpoints, env, headers) as JSON, import it back, or preview what would be exported.
52
+ - **WebDAV**: URL, username, password (https only), Push/Pull. Toggle **Back up daily at 12:00 PM** to auto-push every day at noon local time.
53
+
54
+ ## Development
55
+
56
+ ```sh
57
+ npm install # note: .npmrc sets legacy-peer-deps (two framework rc lines)
58
+ npm run build # server dist/ + client bundle
59
+ npm run check # typecheck (server + client) + sanitizer test
60
+ npm run pack # build + produce dsh-mcp-servers-<version>.tgz
61
+ npm run publish:npm # build + publish to npm (run `npm login` first)
62
+ ```
63
+
64
+ Versioning is date-based and bumps on every build: `1.0.<YYMMDD>` (e.g. `1.0.260817`).
65
+
66
+ The client UI follows the Harness design system: primitives are host-injected externals (`@deepseek-ai/dsh-client-ui-primitives`) and native controls use `--dsw-*` theme tokens with hex fallbacks.
67
+
68
+ ## Notes / limitations
69
+
70
+ - Tool input schemas are whitelist-stripped to the Harness-supported JSON Schema subset (`src/sanitize.ts`); unsupported keywords (`minLength`, `format`, `anyOf`, schema-form `additionalProperties`) are dropped.
71
+ - MCP results render as text; image/resource blocks collapse to JSON/text, not rich blocks.
72
+ - WebDAV requires an https endpoint; credentials in the URL are rejected (passed separately).
73
+ - Config/WebDAV routes are loopback-only.
74
+ - Reconnects are a full pass over all servers (parallel), so one server's drop briefly re-registers the others; status dots are not affected.