乐于分享
好东西不私藏

手把手教你:让 DSH 自动帮你把插件推送到 GitHub

手把手教你:让 DSH 自动帮你把插件推送到 GitHub

还在手动敲 git add、git commit、git push? 想不想直接对着 DSH 说一句“Push my plugin”,它就帮你搞定一切? 今天我们就来配置 DSH 的 MCP 服务,让你的 AI 助手化身 GitHub 管家。


为什么要配 MCP?

MCP(Model Context Protocol)是一个让 AI 工具能够调用外部服务的“万能接口”。 通过配置 GitHub MCP 服务器,DSH 就能直接操作你的仓库——创建仓库、提交代码、推送分支,统统不在话下。


第一步:安装 MCP 客户端插件

DSH 本身不自带 MCP 能力,需要先装上官方客户端插件 @deepseek-ai/dsh-mcp-client

我们推荐使用 @dsh-tools/dsh-install 工具来管理,一条命令搞定依赖:

# 安装管理工具到你的配置dsh plugin --profile install add @dsh-tools/dsh-install# 再把它加到 Web 界面(或其他你想用的 Profile)dsh plugin --profile web add @dsh-tools/dsh-install

装完之后,还需要“激活”一下聚合器。 打开 $DSH_HOME/profiles/web/cordis.patch.yml,把mcp-registry的 disabled 改为 false

- id: mcp-registry  disabled: false   # 改成这样

这样 DSH 就准备好接入各种 MCP 服务器啦。


第二步:添加 GitHub MCP 服务器

这一步有两种做法,推荐方式一(因为最简单)。

方式一:用 dsh-install 命令(省心)

# 从内置目录添加 GitHub 服务器dsh --profile install mcp add github# 或者直接通过 URL 添加(两种任选)dsh --profile install mcp add uvx:mcp-server-git

方式二:手动编辑配置文件(更灵活)

如果你喜欢手动控制,可以修改 cordis.yml,在 plugins 段加入:

- id: mcp-github  name: '@deepseek-ai/dsh-mcp-client'  config:    serverName: github              # 给这个服务起个名字    transport: stdio                # 用标准输入输出通信    command: npx                    # 启动命令    args: ['-y', '@modelcontextprotocol/server-github']  # GitHub 官方 MCP 包    env:      GITHUB_TOKEN: !!js process.env.GITHUB_TOKEN  # 从环境变量读取 Token

保存后重启 DSH,服务器就加好了。


第三步:配置 GitHub Token(关键)

要让 MCP 服务器有权限操作你的仓库,必须提供一个 GitHub Personal Access Token

生成 Token

  •  登录 GitHub,进入 Settings -> Developer settings -> Personal access tokens -> Tokens (classic)。 
  •  点击 Generate new token (classic),勾选权限: 
  • repo(仓库完全控制)——必选
  • workflow(如果需要操作 Actions)
  • 其他按需勾选
  •  生成后复制 Token(形如 ghp_xxxxx)。 

设置环境变量

将 Token 赋值给 GITHUB_TOKEN,你可以临时在终端执行:

export GITHUB_TOKEN=ghp_your_token_here

或者把它写到 ~/.bashrc~/.zshrc 或项目下的 .env 文件中,永久生效。

Warning

千万别把这个文件提交到公开仓库!


第四步:用自然语言指挥 DSH 干活

配置完成后,DSH 就能听懂你的 Git 指令了。 在对话窗口中,你可以直接说:

  • “列出我的 GitHub 仓库” -> 它会调用 API 显示列表
  • “创建一个名为 my-dsh-plugin 的新仓库” -> 一键创建
  • “把 /path/to/plugin 这个本地插件推送到 GitHub” -> 自动 push
  • “提交所有改动,信息为 ‘feat: add new plugin’,然后推送到 origin main” -> 一条龙服务

是不是感觉效率瞬间起飞。


额外小彩蛋:同步插件清单到 Gist

如果你不只是想推送代码,还想备份已安装的插件列表,可以装上 dsh-plugin-sync 插件。 它会自动把你的插件清单导出到 GitHub Gist,换设备时一键恢复,超级方便。


注意事项(安全第一)

  • Token 千万要保密,不要写在代码里,更不要上传到公开仓库。
  • 权限最小化原则:生成 Token 时只给必要的权限,避免滥用风险。
  • 如果遇到连接问题,检查 DSH 日志,确认环境变量是否生效。

结语

现在你已经学会了如何给 DSH 配置 GitHub MCP 服务,从此告别繁琐的手动 Git 操作,让 AI 帮你跑腿。 快去试试吧,如果遇到问题,欢迎在评论区留言交流。

觉得有用的话,点个“在看”分享给更多朋友吧。