dsh-cordis-mcp

DeepSeek Harness の動的 Cordis ツールセットを MCP（Streamable HTTP）として Claude Code に公開します。Claude Code は DSH の動的プラグインをリアルタイムにロード、定義、実行、更新、停止、削除できます。DSH セッションで cordis_define / cordis_run / cordis_stop / cordis_undefine / cordis_inspect_* を使うのとまったく同じ能力、同じランタイムエージェントです。

┌─────────────┐   MCP (Streamable HTTP, loopback)   ┌───────────────────────────┐
│ Claude Code │ ────── http://127.0.0.1:8090/mcp ──▶ │ DSH host (本插件)           │
│  (claude)   │ ────── JSON-RPC 2.0 ───────────────▶ │  dynamicCordisRunner      │
└─────────────┘                                       │  cordisInspect            │
                                                      │  agents (会话解析)         │
                                                      └───────────────────────────┘

プラグインは既存の Web ポートにマウントされ、新しいポートを開いたりサービスを公開したりしません。MCP エンドポイントはBearer 認証を必須とし、トークンは DSH 設定 → dsh-cordis-mcp ページで設定します（初回は自動生成され、カスタマイズ/再生成が可能です）。

機能（10 ツール）

Client half を含むパッケージの初回実行は、引き続き DSH の承認フローを経由します。dsh_plugin_run は awaiting-approval を返し、DSH Web GUI の Run カードで許可をクリックすると非同期に完了します——DSH セッション内と同じです。

Related MCP server: engine

ワンクリックインストール

curl -fsSL https://raw.githubusercontent.com/GeekRicardo/dsh-cordis-mcp/main/install.sh | bash

スクリプトが行うこと（事前に --dry-run でプレビュー可能）:

1. ~/.dsh/profiles/web/package.json に依存関係 "dsh-cordis-mcp": "github:GeekRicardo/dsh-cordis-mcp" を書き込む。

2. dsh-cordis-mcp を dsh.profile.bundles に追加する。

3. cd ~/.dsh/profiles/web && pnpm install を実行する。

4. bundles が登録されたことを検証し、再起動を促す。

DSH を再起動してページをハードリフレッシュすると、MCP エンドポイントが Web サービスとともに利用可能になります:

pm2 restart dsh-web   # 若用 pm2 托管；否则用你的启动方式重启

Claude Code への接続

# 端口换成你 DSH web 的实际端口（启动日志会打印完整地址）
claude mcp add dsh --transport http http://127.0.0.1:8090/mcp
claude mcp list          # 确认 connected

認証（必須、直接接続不可）

MCP エンドポイントはBearer 認証を必須とし、トークンがない場合はすべて 401（トークン未設定の場合は 503）を返します。トークンは DSH 設定 → dsh-cordis-mcp ページで設定します。初回使用時に自動生成されて永続化され、ページで表示/コピー/カスタマイズ/再生成が可能です。トークンを .mcp.json のリクエストヘッダーに記入します:

{
  "mcpServers": {
    "dsh": {
      "type": "http",
      "url": "http://127.0.0.1:8090/mcp",
      "headers": { "Authorization": "Bearer <设置页里的 token>" }
    }
  }
}

トークンの解決優先順位: 設定ページの設定 > DSH_MCP_TOKEN 環境変数 > 自動生成。トークンを変更すると即座に有効になります（再起動不要）。再生成後は古いトークンが即座に無効になるため、Claude Code の設定も同期して更新する必要があります。

セッションセマンティクス（重要）

動的プラグインはセッション単位で、プロセスのメモリ状態です（DSH を再起動すると消去されます）。ブリッジのセッション解決順序:

1. 呼び出しパラメータの sessionId（dsh_sessions で確認可能）。

2. 環境変数 DSH_MCP_DEFAULT_SESSION で指定。

3. 現在の唯一のライブセッション。

4. ライブセッションが複数あるが未指定の場合 → エラーで選択肢を列挙し、sessionId を渡すよう要求。

その他の環境変数

セキュリティ境界

• Bearer 認証を必須：トークンがない場合はすべて 401 / 503。エンドポイントは常に直接接続不可。

• loopback Host（127.* / localhost / ::1）のみ受け入れ、外部からのアクセスはすべて拒否。

• sec-fetch-site: cross-site のブラウザリクエストを拒否し、CORS ヘッダーは決して返さない——Web ページはレスポンスを読み取れない。

• 設定ページのルート /dsh-cordis-mcp/settings は同一オリジンの loopback のみ許可（MCP トークンは不要だが、変更できるのはトークン設定自体のみ）。

• このエンドポイントはプラグインの define/run/削除が可能で、シェル権限と同等です。ポートをローカル以外に公開しないでください。

動作原理

アンインストール

# 1. 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 移除 "dsh-cordis-mcp"
# 2. 移除 dependencies 里的 "dsh-cordis-mcp"
# 3. cd ~/.dsh/profiles/web && pnpm install
# 4. 重启 DSH；claude mcp remove dsh

前提条件

• DeepSeek Harness が web profile を初期化済み（~/.dsh/profiles/web が存在）で、現在のセッションが Cordis ツールセット付きの preset で動作していること（ホスト側の dynamicCordisRunner サービスが存在。デフォルトで有り）。

• ローカルに Claude Code CLI がインストールされ、ログイン済みであること。

• Node.js ≥ 20、pnpm が利用可能であること。

Troubleshooting

License

MIT