activeing123/dsh-mcptoon

dsh-mcptoon

English | 中文

A DeepSeek Harness plugin bundle that mounts mcptoon as an MCP server in one command, so the host agent discovers its MCP tools through mcptoon's compressed view instead of paying full JSON schemas on every turn.

Measured on a 255-tool workspace: tool discovery drops 71,929 -> 581 tokens across 255 tools (-99.2%, measured). The encoding is lossless — mcptoon only changes how tool definitions travel, never what they say.

What you get

After installing, the model sees mcp__mcptoon__<tool> — the same server-qualified naming other MCP hosts use — and every upstream MCP server you have already configured is proxied behind that single stdio connection.

Install

dsh plugin --profile web add github:activeing123/dsh-mcptoon

Or, once the package is on npm:

dsh plugin --profile web add dsh-mcptoon

Then restart the profile (or rely on HMR: editing the entry reconnects the bridge without a process restart).

Requirements

• Python 3.9+ with the mcptoon CLI on PATH: pip install mcptoon (zero dependencies, installs in seconds).
• Review the version before you upgrade: pip install "mcptoon==<reviewed>" is the safer default than an unconditional --upgrade.

If the bridge does not come up

The bundle prints a self-check line at activation. When it says not ready, the CLI is not where command points — common on Windows, where pip installs mcptoon.exe next to an interpreter that is not on PATH, often under a path containing a space (C:\Program Files\...).

Get the absolute path — the bundled doctor prints the exact override block:

npx dsh-mcptoon-doctor          # or: node bin/doctor.mjs inside a checkout
python -c "import shutil;print(shutil.which('mcptoon'))"

Then override in your profile's own cordis.patch.yml — one executable in command, arguments in the args array, never a spaced shell string:

- id: mcp-mcptoon
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: mcptoon
    transport: stdio
    command: 'C:\Program Files\Python312\Scripts\mcptoon.exe'
    args: ['serve']

Sanity-check the composed profile without booting the app:

dsh --profile web --dump-config | grep -A6 mcp-mcptoon

How it works

This package is a bundle: its package.json declares dsh.bundle.patch, and the patch file it points at inserts one entry into the profile's plugin list — an instance of the official @deepseek-ai/dsh-mcp-client bridge configured for mcptoon serve. The bundle only ever inserts; it never rewrites entries it does not own.

Relationship to the Claude Code plugin

mcptoon also ships a Claude Code plugin (plugin.json + SKILL.md + .mcp.json) in the upstream repository. That packaging was the first to bundle MCP management and compression as an installable plugin. This DSH bundle is a second host wrapper, not an endorsement or official support statement from either project.

License

Apache-2.0. mcptoon itself lives in activeing123/mcptoon and is distributed on PyPI.