dsh-mcp-server

DeepSeek Harness の Agent（dsh、ファイル・ターミナル・ウェブ検索・サブエージェント・ワークフローを備えたコーディング Agent）を、Model Context Protocol を通じてローカルで利用可能なモデルバックエンドとして公開し、同時に「私を理解する / 私を改造する」ためのインターフェースも公開します。

┌────────────────────────────┐        stdio / HTTP         ┌──────────────────────────────┐
│  其他 Agent / MCP 客户端     │  ────────────────────────▶  │        dsh-mcp-server         │
│  (Claude Desktop, Cursor,  │                            │  方向A：驱动我（消耗我的额度）  │
│   Claude Code, 自定义程序)   │                            │  方向B：读懂我/改造我（便宜）   │
└────────────────────────────┘                            └──────────────┬───────────────┘
                                                                         │ spawn
                                                              ┌──────────▼───────────────┐
                                                              │  dsh Agent（完整工具链）    │
                                                              │  DeepSeek 模型（默认）      │
                                                              └──────────────────────────┘

2つの方向性

方向 A：私を駆動する —— DeepSeek Harness のクォータを消費、ユーザー確認が必須

dsh_ask / dsh_converse / dsh_tool は呼び出しのたびに完全な dsh Agent プロセスを起動し、その Agent が（DeepSeek モデルを使って）実際の作業を行います：ファイルの読み書き、コマンド実行、ウェブ検索、サブエージェントの派遣。これは DeepSeek Harness のトークンクォータを消費します。そのため：

1. 呼び出しはまず confirmation_required を返し（この時点ではクォータを一切消費しません）、「DeepSeek Harness のクォータを消費します」と明確に通知します；

2. 呼び出し側はこのリクエストをユーザーに表示する必要があります（MCP クライアントは通常、ツール呼び出しを自動表示します）；

3. ユーザーが承認した後、dsh_confirm(requestId, approve=true) を呼び出して初めて実際に実行されます。または dsh_deny(requestId) でキャンセルします。

各保留中のリクエストはサーバーの stderr にも目立つ警告が1行出力されます。未確認のリクエストは10分で期限切れになります。

⚠️ リスクスイッチ：DSH_MCP_AUTO_APPROVE=1 で確認ゲートをスキップします（無人運用・完全に信頼できる環境向け）。単発の呼び出しでも confirm: false を渡せばスキップできます。

方向 B：私を理解する / 私を改造する —— 相手側のトークンを消費、サーバー側は非常に安価

他の Agent が「私は何か、どう設計されているか、どうやってプラグインを作るか / 設定を変更するか」を理解したい場合、これらのインターフェースを使います（サーバーはローカルでの読み取り・検証のみを行い、dsh モデルのクォータは消費しません。相手のモデルが結果を自分のコンテキストに読み込む際、消費するのは相手自身のトークンです）：

典型的な使い方：外部 Agent はまず dsh://self/* リソースを読んで設計を理解し（その Agent のトークンを消費）、次に dsh_patch_config を呼び出して設定変更を提案します（例：モデル変更、新しいスキルのマウント、特定プラグインの無効化）。または dsh_plugin_contract に従ってローカルに dsh プラグインを作成します。

Related MCP server: dsh-orchestrator

クイックスタート

cd E:\DeepSeek Harness\dsh-mcp
npm install          # 安装 @modelcontextprotocol/sdk

# 冒烟测试：不经过 MCP，直接验证 dsh Agent 后端可用
node scripts/smoke.mjs

# 以 stdio 传输启动服务器（MCP 客户端的标准方式）
node src/index.js

サーバーはローカルにインストールされた dsh を自動検出します（npx キャッシュ / npm キャッシュ / カレントディレクトリをスキャン）。設定は不要です。 見つからない場合は環境変数で指定：DSH_MCP_DSH_BIN=C:\...\@deepseek-ai\dsh\lib\bin.js。

Claude Desktop への接続

%APPDATA%\Claude\claude_desktop_config.json を編集：

{
  "mcpServers": {
    "dsh": {
      "command": "node",
      "args": ["E:\\DeepSeek Harness\\dsh-mcp\\src\\index.js"]
    }
  }
}

Claude Code / Cursor / VS Code への接続

それぞれ examples/claude-code.json、examples/cursor-mcp.json、examples/vscode.json を使用します。

独自の Agent への接続（HTTP 方式）

node src/index.js --transport http --port 3005
# 端点：http://127.0.0.1:3005/mcp  （Streamable HTTP）

ツール一覧

環境変数

権限とセキュリティ

• dsh Agent は dsh の権限体系を継承：デフォルトは workspace-write（ワークディレクトリのみ書き込み可能）、read-only / danger-full-access に変更可能。

• 方向 A のすべての実行は確認ゲートを通過し、クォータ消費が明確に開示されます。

• 方向 B の読み取り専用パスではシークレット値は一切マスクされません。書き込みパス（dsh_patch_config）はデフォルトで dry-run、書き込み前に自動バックアップ、確認が必要で、home 層への変更はすべての profile（実行中の Web UI を含む）に影響することを警告します。

• セッションは ~/.dsh/sessions に永続化され、認証情報は ~/.dsh/.credentials.yaml を共有します。

• サーバーはローカルのみをリッスンします（stdio パイプ / 127.0.0.1）。

モデル変更（方向 B の典型的な使い方）

デフォルトモデルは dsh の agent-default-model（ローカル deepseek-official / deepseek-v4-flash）から取得されます。変更方法：

1. dsh_patch_config を使用（推奨）：home 層にパッチを送信し、dry-run 検証が成功し、ユーザー確認後に書き込みます（自動バックアップ）。パッチ例：

   - id: agent-default-model
     config:
       provider: deepseek-official
       model: deepseek-chat

2. グローバル設定を変更：~/.dsh/settings.yaml の agent-default-model セクションを編集。

3. profile 全体を変更：DSH_MCP_PROFILE で別の profile を指定（異なるツールセット/ペルソナ）。

既知の制限

• 方向 A は呼び出しのたびに新しいプロセス（約2〜3秒のコールドスタート + モデル応答）、ストリーミングなし、タスクテキストは ≤ ~30k 文字。

• 確認ゲートは、呼び出し側が confirmation_required をユーザーに表示することに依存します。呼び出し側が無人運用プログラムで DSH_MCP_AUTO_APPROVE が未設定の場合、リクエストは期限切れまで保留されたままになります。

• リソース/ツール数：6 リソース + 11 ツール。

開発とテスト

node scripts/smoke.mjs              # 仅测 dsh 后端（无 MCP）
node scripts/demo.mjs               # 演示：确认闸门 + 读懂我 + 改配置提议
node scripts/mcp-client-test.mjs    # stdio 端到端：闸门/拒绝/多轮/自省/patch/资源
node scripts/http-client-test.mjs   # HTTP 端到端（自动批准模式）

ディレクトリ構造

dsh-mcp/
├── src/
│   ├── index.js     # CLI 入口（stdio / HTTP 传输）
│   ├── server.js    # MCP 工具与资源注册
│   ├── dsh.js       # dsh 子进程运行器（spawn/超时/输出捕获/并发闸门）
│   ├── approvals.js # 确认闸门（额度披露、待确认队列、过期）
│   ├── self.js      # 自省：设计快照、技能发现、配置路径、插件契约
│   └── sessions.js  # 会话记忆与多轮提示组装
├── scripts/         # 冒烟 + 演示 + 端到端测试
└── examples/        # 各客户端接入配置