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 +21 -0
- package/README.md +74 -0
- package/client/client.js +1133 -0
- package/cordis.patch.yml +3 -0
- package/dist/index.d.ts +23 -0
- package/dist/index.js +473 -0
- package/dist/sanitize.d.ts +1 -0
- package/dist/sanitize.js +39 -0
- package/package.json +69 -0
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.
|