dsh-tools-mcp

deepseek-harness（DeepSeek AI がオープンソース化した agent harness）から ミニマルモード（minimal） と スタンダードモード（standard） の tools を抽出し、MCP（Model Context Protocol） サーバーとしてラップします。--mode パラメータで公開するツールセットを制御します。

ツールの schema、説明文、出力エンベロープ（read の <path>/<type>/<content> 形式、str_replace_editor の view/create/str_replace/insert セマンティクス、[exit code: N] マーカーなど）は、すべて元リポジトリの apps/cli/config/agent-presets/{minimal,standard}/agent.cordis.yml と対応する packages/*/tool-* 実装から忠実に再現しています。

モードとツール対照表

スタンダードモードは --with-web-fetch により web_fetch を追加公開することもできます（元の standard プリセットはデフォルトで fetch: false）。

Related MCP server: deepseek-agent-mcp

クイックスタート

cd dsh-tools-mcp
npm install
npm run build          # 输出到 dist/

# 极简模式
node dist/index.js --mode minimal --cwd D:/develop/project/dsh-tools-mcp

# 标准模式
node dist/index.js --mode standard --cwd D:/develop/project/dsh-tools-mcp

MCP クライアント設定

// mcp.json / WorkBuddy 自定义连接器
{
  "mcpServers": {
    "dsh-minimal": {
      "command": "node",
      "args": ["D:/develop/project/dsh-tools-mcp/dist/index.js", "--mode", "minimal", "--cwd", "D:/develop/project/dsh-tools-mcp"]
    },
    "dsh-standard": {
      "command": "node",
      "args": ["D:/develop/project/dsh-tools-mcp/dist/index.js", "--mode", "standard", "--cwd", "D:/develop/project/dsh-tools-mcp"]
    }
  }
}

2つのエントリを同時に登録でき、必要に応じてミニマル/スタンダードのツールセットを選択できます。

全パラメータ

--mode <minimal|standard>    Agent 预设模式（默认 minimal）
--cwd <path>                 工作区根目录，文件工具基于它解析相对路径（默认 process.cwd()）
--shell <auto|bash|pwsh>     shell 后端；auto = win32 用 pwsh，其余用 bash
--shell-timeout-ms <n>       持久 shell 单条命令超时（默认 300000）
--max-output-chars <n>       输出截断上限（默认 16000）
--skills-dir <path>          启用 skill 工具，扫描该目录下的 SKILL.md 子目录
--search-provider <duckduckgo|tavily|bing>   web 搜索后端（默认 duckduckgo）
--search-api-key <key>       tavily/bing 的 API key
--proxy <url>                web 工具的 HTTP(S) 代理，如 http://127.0.0.1:7897
--with-web-fetch             额外暴露 web_fetch
--allow-outside-root         允许文件工具访问 --cwd 之外的路径（默认禁止）
--tools <a,b,c>              显式指定工具/套件清单覆盖模式（见下）
--help / --version

--tools オーバーライド

--tools はツール名またはスイート名を受け付け、必要に応じてサブセットを公開します：

# 只要文件相关
node dist/index.js --mode standard --tools read,write,edit,glob,grep

# 只要极简模式的编辑器 + 后台任务
node dist/index.js --mode minimal --tools str_replace_editor,job_output,job_list,job_kill

スイート名：shell（永続 shell）、one-shot、fs、search、jobs、todo、web、ask-user、goal、plan、skill。

設計上の注意

• 永続 shell：node-pty に依存せず、stdio パイプで常駐 bash/powershell 子プロセスを駆動します。コマンドはランダムな UUID マーカーで囲んで完了状態と終了コードを確実に捕捉します。cd/export などの状態は呼び出しをまたいで保持され、タイムアウトまたは shell 終了時に自動リセットされます（元の tool-bash-persistent セマンティクスと一致）。

• パス安全性：デフォルトのファイルツールは --cwd ワークスペース内のパスのみアクセスを許可し、範囲外の場合はエラーとなり --allow-outside-root の追加を促します。

• web_search はデフォルトで DuckDuckGo（キー不要）。中国国内のネットワークでは --proxy http://127.0.0.1:7897 を推奨。または --search-provider tavily --search-api-key <key> に切り替えます。

• 状態はすべてプロセス内（セッションレベル）：todo/goal/plan/バックグラウンドタスクの状態はサーバープロセスのライフサイクルに従い、再起動するとクリアされます——元の「セッションレベル状態」と同等です。

元の dsh との差異（明確な説明）

未ラップのツール（元の standard プリセット内のランタイム結合ツールで、完全な dsh runtime が必要）：subagent_control、list_agents、subagent、subagent_fork、workflow、ralph。これらの機能が必要な場合は、deepseek-harness 本体を直接使用してください。

テスト

npm run build
npm test          # 冒烟测试：两种模式工具暴露 + 核心工具行为 + --tools 覆写
node scripts/state-test.mjs   # 持久 shell 状态保持 / 退出码 / 优雅重置（PROXY=... 可测 web_search）
node scripts/bash-test.mjs    # bash 后端验证

ソースコード参照

deepseek-ai/deepseek-harness（MIT License、master ブランチ）から抽出：

• モード定義：apps/cli/config/agent-presets/minimal/agent.cordis.yml、.../standard/agent.cordis.yml

• ツール実装：packages/shell/tool-bash-persistent、packages/fs/tool-str-replace-editor、packages/fs/tool-fs、packages/fs/tool-fs-search、packages/jobs/tool-jobs、packages/todo/tool-todo、packages/web/tool-web、packages/interaction/tool-ask-user、packages/goal/tool-goal、packages/plan/plan-mode、packages/skill/tool-skill など