DSH MCP Server

前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在本地 Harness 環境中運行的代理，通常被限制在內部運行，無法被其他外部 harness（如 Claude Code、Cursor 等）直接調用。DSH MCP Server 插件通過 Model Context Protocol (MCP) 從運行 Harness 的主機發佈一個服務端點，允許其他 agent harness 通過 Streamable HTTP 或 stdio 協議與 DSH 交互。它將 DSH 的會話、代理和工具暴露給外部調用者，使其能夠啓動會話、驅動對話輪次、讀取日誌以及取消任務。

插件定位¶

• 名稱：@local/dsh-mcp-server
• 維護者：baitouwuya
• 許可證：MIT
• 類型：Host-only bundle（零依賴，無 DSH 導入，無第三方模塊）

核心能力¶

該插件通過 MCP 協議提供了一系列工具，用於控制和管理 DSH 會話。支持的通信方式爲 Streamable HTTP 或 stdio。

會話控制¶

• 啓動與繼續：dsh_run_prompt 用於啓動新會話並運行 Prompt；dsh_continue_session 用於向現有會話發送 Prompt 並保持上下文。
• 查詢與管理：dsh_list_sessions 用於分頁列出會話索引；dsh_read_session 用於讀取會話的對話記錄（僅用戶和助手消息）；dsh_cancel_session 用於取消會話的當前活動輪次。
• 歸檔：dsh_archive_session 和 dsh_unarchive_session 用於將會話歸檔或取消歸檔。

命令與工具¶

• 執行命令：dsh_run_command 用於在會話中運行斜槓命令（如 /compact）；dsh_list_commands 用於列出當前會話代理可用的斜槓命令。
• 工具發現：dsh_list_tools 用於列出 DSH 暴露給自身代理的工具，以便在委託 Prompt 中選擇權限。

狀態與權限¶

• 狀態監控：dsh_status 返回端點、配置、版本、會話計數、活動輪次和默認權限預設信息。
• 身份歸屬：dsh_whoami 返回調用者的身份標識（基於 Header 或 User-Agent）及其創建的會話列表。注意：這屬於歸屬機制，非嚴格認證。
• 權限預設：dsh_list_permission_presets 用於列出部署的權限預設。
• 決策等待：dsh_answer_request 用於回答掛起的決策（審批或提問）；dsh_list_requests 用於列出會話當前等待的用戶決策；dsh_wait_session 用於阻塞等待會話當前輪次結束。

典型用法¶

1. 啓動新會話
   調用 dsh_run_prompt 工具，傳入 Prompt 文本及參數（如 cwd、model、permissionPreset），即可開始一個新的 DSH 對話。

2. 繼續現有會話
   使用 dsh_continue_session，傳入 sessionId 和後續 Prompt，在不丟失上下文的情況下繼續對話。

3. 列出運行中的會話
   調用 dsh_list_sessions，可以查看所有會話的 ID、標題和運行狀態。通過 mine: true 參數可過濾出當前調用者創建的會話。

4. 運行斜槓命令
   使用 dsh_run_command 在會話中執行命令。例如傳入 "/compact"，命令會立即執行，不經過模型輪次。

注意事項與依賴¶

• 零依賴：插件是一個 Host-only bundle，不包含 DSH 導入或第三方模塊。只要 Harness 的服務契約保持不變，該插件可以隨 Harness 升級而存活。
• 歸屬機制：調用者通過 Header 或 User-Agent 標識自己，系統記錄會話歸屬者。這屬於歸屬機制，非嚴格認證；調用者共享端點 Token。
• 功能依賴：
  • 歸檔功能：需要 Host 的 workspaceRegistry 服務（@deepseek-ai/dsh-workspace）。否則歸檔工具會報告服務不可用，列表中也不會顯示歸檔字段。
  • 權限預設：需要 Host 的 permissionPresets 服務（@deepseek-ai/dsh-permission-presets）。否則權限相關字段會缺失。
  • 命令功能：需要 Host 的 commands 服務。
• 安裝：官方文檔未提供具體的安裝命令，建議參考 GitHub 倉庫 的說明進行部署。

總結¶

DSH MCP Server 充當了 DeepSeek Harness 與外部 Agent Harness 之間的橋樑。它允許外部工具完全控制 DSH 的會話生命週期，同時保持了 Harness 的原生插件架構優勢。