把 mcptoon 作为一条 stdio MCP 服务接入,让 agent 通过 mcptoon 的压缩视图发现已配置 MCP server 的工具,而非每轮支付完整 JSON schema。附带 doctor CLI:校验 mcptoon 可执行文件能否解析,不能时打印精确的 command/args 覆盖配置。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:activeing123/dsh-mcptoon
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 中文
一个 DeepSeek Harness 插件包(bundle):一条命令把 mcptoon 挂成 MCP server,让宿主 Agent 的 MCP 工具发现环节走 mcptoon 的压缩视图,而不再为每一轮重复支付完整的 JSON schema。
**在 255 个工具的工作区实测:工具发现 71,929 → 581 tokens across 255 tools (-99.2%, measured)。**编码无损——mcptoon 只改变工具定义的传输方式,不改变内容。
装完你会得到什么
模型侧看到 mcp__mcptoon__<tool>(与其它 MCP 宿主一致的「服务器限定名」),
而你原本已经配好的所有 MCP server,都被代理在这一条 stdio 连接后面。
安装
dsh plugin --profile web add github:activeing123/dsh-mcptoon
包上 npm 之后可以写成:
dsh plugin --profile web add dsh-mcptoon
然后重启 profile;改配置也可靠 HMR 热替换(同名 serverName 会重连桥接,不用重启进程)。
前置要求
- Python 3.9+,且 mcptoon CLI 在
PATH上:pip install mcptoon(零依赖,秒装)。 - 升级前先看一眼版本:更稳的写法是
pip install "mcptoon==<你审过的版本>", 而不是无条件--upgrade。
桥接没起来怎么办
这个 bundle 在激活时会自检并打一行提示。若显示 not ready,说明 command
指不到可执行文件——Windows 上很常见:pip 把 mcptoon.exe 装到解释器同级目录,
而那个目录常常不在 PATH 上,路径里还带空格(C:\Program Files\...)。
先拿到绝对路径:
python -c "import shutil;print(shutil.which('mcptoon'))"
然后在你自己 profile 的 cordis.patch.yml 里覆盖——command 只放一个可执行文件,
参数一律进 args 数组,绝不要写成带空格的整串命令行:
- id: mcp-mcptoon
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: mcptoon
transport: stdio
command: 'C:\Program Files\Python312\Scripts\mcptoon.exe'
args: ['serve']
不启动应用也能核对最终配置:
dsh --profile web --dump-config | grep -A6 mcp-mcptoon
它是怎么工作的
本包是一个 bundle:package.json 里声明 dsh.bundle.patch,指向的补丁文件向
profile 的插件列表里插入一个条目——即官方 @deepseek-ai/dsh-mcp-client 桥接插件
的一个实例,配置为 mcptoon serve。这个包只做 insert,不会改写任何不属于它的条目。
和 Claude Code 插件的关系
mcptoon 在上游仓库里同时提供了 Claude Code 插件(plugin.json + SKILL.md +
.mcp.json),那是第一次把「MCP 管理 + 压缩」做成可安装插件的形态。本 DSH bundle
是第二种宿主包装,不代表任何一方给出官方支持或背书。
许可
Apache-2.0。mcptoon 本体在 activeing123/mcptoon, 通过 PyPI 分发。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 28100
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
superdesigndev/treg★ 1740
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1118
把腾讯云 CloudBase 后端接入 DeepSeek Harness——在对话里搭好并部署全栈应用,查询结果渲染为表格卡片(分页、排序、导出 CSV),部署后可预览真实域名,并提供 CloudBase MCP 工具集(`mcp__cloudbase__*`),登录走 device-code 流程。
gitroomhq/postiz-agent#dsh-postiz★ 481
通过 MCP 将 DeepSeek Harness 连接到 Postiz:列出已连接的社交媒体渠道、获取各平台发帖规则,并向 X、LinkedIn、Instagram、Facebook、Threads、TikTok、YouTube、Reddit、Bluesky、Mastodon、Discord、Slack、Telegram 等平台排期、存草稿或发布帖子;附带 postiz 工作流技能。
EthanYoQ/Invoice-Downloader#dsh-invoice-downloader★ 434
面向 DeepSeek Harness 的本地 IMAP 发票下载、OCR 识别、归档与 Excel 报销汇总。
anysearch-team/anysearch-dsh★ 422
基于 AnySearch 的实时网页与垂直搜索插件,为 DeepSeek Harness 提供搜索工具。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。