前言¶
DeepSeek Harness (DSH) 採用插件化架構。開發者需要通過 MCP 協議與 GitHub 交互時，dsh-github-mcp 插件提供了直接的連接方案。它將 GitHub MCP 封裝爲 DSH 插件，並將認證 Token 存儲在 DSH 憑據中心，避免 Token 暴露在代碼或日誌中。
核心功能¶
- GitHub MCP 連接：通過
@deepseek-ai/dsh-mcp-client連接官方遠程服務器，提供 40+ 個 GitHub 工具，工具名稱以mcp__github__*爲前綴。 - Token 存儲管理：GitHub Personal Access Token (PAT) 存儲在 DSH 憑據中心（
.credentials.yaml），不寫入源碼或日誌。 - 模型工具：
-github_token_status：查看 Token 配置狀態、來源及可寫性。
-github_set_token：在對話中直接輸入 Token 以更新憑據中心。 - 面板插件：自動捆綁安裝
dsh-github-mcp-hint（需額外啓用）。
安裝與啓用¶
使用以下命令安裝主插件：
dsh plugin --profile web add dsh-github-mcp
安裝包會自動包含 dsh-github-mcp-hint 作爲依賴，但 DSH 僅將頂層依賴加入 profile 的 bundles 層，因此面板插件不會自動啓用。若需要“設置 → 插件 → GitHub MCP”面板，需單獨執行：
dsh plugin --profile web add dsh-github-mcp-hint
前置條件¶
- DSH 版本：依賴
@deepseek-ai/dsh-mcp-client（DSH 核心），需 DSH 版本 >= 0.1.x。 - GitHub PAT：生成 Personal Access Token，作用域需包含
repo、read:org、read:packages。
配置與使用¶
設置 Token¶
有兩種方式配置 Token：
1. 模型工具：在對話中直接說“幫我把 GitHub token 設爲 ghp_xxx”，模型會調用 github_set_token 寫入憑據中心。
2. 編輯憑據中心：直接編輯 ~/.dsh/.credentials.yaml，在 refs: 下添加 GITHUB_TOKEN: ghp_xxx。
注意：修改 Token 後必須重啓 DSH 才能生效。
常見操作¶
- 查看狀態：詢問“我的 GitHub token 配好了嗎”。
- 搜索倉庫：詢問“在 owner/repo 裏搜索關鍵詞 xxx”。
- 管理 PR/Issue：通過自然語言指令調用
mcp__github__*工具進行創建、評論、合併等操作。
注意事項¶
- 環境變量衝突：若環境變量中已存在
GITHUB_TOKEN，寫入憑據中心會被拒絕。需先取消環境變量再使用模型工具或編輯文件。 - 重啓生效：Token 修改後需重啓 DSH，因爲
mcp-client在啓動時讀取 Token。 - 面板插件依賴：
dsh-github-mcp-hint需單獨安裝並加入 profile bundles 才能顯示面板 UI。
