dsh-github-mcp
把 GitHub MCP 整体封装成一个 DSH 插件：接入 GitHub 官方远程 MCP Server，token 存到 DSH 凭据中心（.credentials.yaml），可通过模型工具输入；GitHub 工具以 mcp__github__* 形式可用。自动捆绑安装面板插件 dsh-github-mcp-hint（可独立卸载）。
📚 功能
- GitHub MCP 连接：通过
@deepseek-ai/dsh-mcp-client 连接 https://api.githubcopilot.com/mcp/，GitHub 工具以 mcp__github__* 名称出现（search_repositories、list_pull_requests、create_pull_request、push_files、get_file_contents、merge_pull_request、add_issue_comment …共 40+ 个）。
- token 存到凭据中心：GitHub PAT 存在 DSH 的
.credentials.yaml（refs.GITHUB_TOKEN），不写入源码、不进日志。
- 模型工具：
github_token_status — 查看 token 是否已配置、来源、是否可写。github_set_token — 输入/更新 token（写入凭据中心并刷新当前环境）。
- 自动捆绑面板插件
dsh-github-mcp-hint：设置 → 插件 → GitHub MCP 的示例 + 公开仓库统计 UI。
🚀 快速开始
# 1. 安装（会一并装上依赖的面板插件 dsh-github-mcp-hint）
dsh plugin --profile web add dsh-github-mcp # 若已发布到 npm
# —— 或 ——
dsh plugin --profile web add github:ZIye1208/dsh-github-mcp # 从 GitHub 安装
# 2. 设置 token（对话里说即可）
# “帮我把 GitHub token 设为 ghp_xxx”
# 3. 重启 DSH，然后问
# “我的 GitHub token 配好了吗” （github_token_status）
# “看看我的仓库有多少星多少下载”（走 mcp__github__* / 面板）
⚙️ 安装
方式一：npm（推荐，发布后可用）
dsh plugin --profile web add dsh-github-mcp
会自动携带依赖 dsh-github-mcp-hint。
关于 npm 发布：本包已按可发布到 npm 配置（publishConfig.access: public、files 白名单、main/exports 正确）。要在 npm 上安装，需先把包发布到 npm registry：在具备 npm 账号（npm login / 配好 token）后执行 npm publish。当前只发布了 GitHub 版。
方式二：GitHub
dsh plugin --profile web add github:ZIye1208/dsh-github-mcp
方式三：本地开发
# 在 profile 的 package.json 用 link 指向本地路径，并加入 dsh.profile.bundles，然后重启 DSH
🔑 前置条件
- DSH 版本 >= 0.1.x（本插件依赖
@deepseek-ai/dsh-mcp-client，属 DSH 核心）。
- GitHub PAT：在 GitHub → Settings → Developer settings → Personal access tokens 生成，需作用域
repo、read:org、read:packages（用于 MCP 读写仓库/PR/issue）。
🔐 设置 token（三选一）
方式 A：模型工具（推荐）
在对话里说：
帮我把 GitHub token 设为 ghp_xxxxxxxx
agent 调用 github_set_token，写入 ~/.dsh/.credentials.yaml 的 refs.GITHUB_TOKEN，并更新当前环境变量。
方式 B：直接编辑凭据中心
编辑 ~/.dsh/.credentials.yaml，在 refs: 下加一行：
version: 1
refs:
GITHUB_TOKEN: ghp_xxxxxxxx
# records:
# ...
保存后，下一次 DSH 启动时插件会自动把它桥上到 process.env.GITHUB_TOKEN。
方式 C：环境变量（传统）
在启动 shell 设 GITHUB_TOKEN=ghp_xxx 后启动 DSH。注意：一旦环境里已有 GITHUB_TOKEN，它优先且只读，github_set_token 写入凭据中心会被拒绝——需先 unset GITHUB_TOKEN 再用方式 A/B。
⚠️ 修改 token 后需重启 DSH 才生效：mcp-client 在启动时读取 token（静态 header），运行中不会重连。
🧭 使用
- 看 token 状态：问「我的 GitHub token 配好了吗」→
github_token_status。
- 列 PR / 建 PR / 推代码 / 改文件 / 搜代码：直接用自然语言，模型会调
mcp__github__*。示例：
- “查看仓库 owner/repo 里所有 open 状态的 Pull Request，按更新时间倒序”
- “在当前分支提交所有改动并推送到 GitHub，提交消息按变更自动生成”
- “给 owner/repo 的 PR #123 添加一条评论说明测试已通过，并标记 ready for review”
- “在 owner/repo 里搜索关键词 xxx 的代码文件”
- 面板 UI：设置 → 插件 → GitHub MCP（由
dsh-github-mcp-hint 提供，随机 4/30 条示例、公开仓库统计）。
🗑️ 卸载 / 禁用
卸载整个插件（含面板）
dsh plugin --profile web remove dsh-github-mcp
只卸载面板插件（不影响 GitHub MCP）
dsh-github-mcp 自动捆绑安装了面板插件 dsh-github-mcp-hint（作为依赖）。可独立卸载：
- 从 profile 的
dsh.profile.bundles 移除 dsh-github-mcp-hint；
- 卸载该包：
dsh plugin --profile web remove dsh-github-mcp-hint。
卸载面板后，github_token_status / github_set_token 及所有 mcp__github__* 仍可用。
只禁用面板（不卸载）
在 profile 的 cordis.patch.yml 给面板行加：
- id: dsh-github-mcp-hint
disabled: true
🧩 架构（为什么这么设计）
用户输入 token ──(github_set_token)──► DS H 凭据中心 .credentials.yaml (refs.GITHUB_TOKEN)
│
▼ 启动时插件桥接
process.env.GITHUB_TOKEN
│
▼ mcp-client 启动读取
Authorization: Bearer <token> ──► https://api.githubcopilot.com/mcp/
│
▼
注册 mcp__github__* 工具（模型可调）
dsh-github-mcp = GitHub MCP 连接 + token 凭据中心。dsh-github-mcp-hint = 面板 UI（独立仓库，可卸载）。- 为什么 token 在凭据中心而不是环境：DSH 官方凭据存储（
.credentials.yaml）不会自动注入 process.env，所以插件在启动时做一次「凭据中心 → 环境变量」的桥接，让 mcp-client 能读到。
❓ 常见问题
mcp__github__* 没出现：多半是 token 未配置或未重启。先 github_token_status，再重启 DSH。github_set_token 被拒：启动环境里已有 GITHUB_TOKEN（只读）。先 unset GITHUB_TOKEN，再用工具保存到凭据中心。serverName "github" already in use：你在 profile 里手动加过 mcp-github 行。删掉那行，交给本插件的 cordis.patch.yml（含 mcp-github 行）管理。- token 改了不生效：重启 DSH（mcp-client 启动时读一次）。
📄 仓库关系
| 仓库 | 作用 |
|---|
ZIye1208/dsh-github-mcp | GitHub MCP 连接 + token 凭据中心（本插件） |
ZIye1208/dsh-github-mcp-hint | 面板 UI（独立、可卸载） |
许可
MIT
