在VSCode中通过Cline插件(并配置GitHub MCP服务器)

文章内容

  • Cline MCP
  • 准备工作
  • Cline插件安装
  • 安装并配置GitHub MCP服务器
  • 使用Cline操作GitHub

Cline MCP

Cline MCP 是人工智能开发领域的一项重要技术组合,由 Cline(一款集成开发环境插件)与 Model Context Protocol (MCP)(模型上下文协议)深度融合而成。其核心功能包括:

  • 代码生成与自动化
  • 工具生态扩展
  • 人机协作机制

准备工作

  1. 安装VScode https://code.visualstudio.com/Download
  2. 安装Node.js https://nodejs.org/zh-cn/download
# 通过终端查看是否安装完成
node -v
v22.21.0

npx -v
10.9.4
  1. 准备一个大语言模型API,可以是本地部署的Ollama,也可以是其他,这里为了方便使用deepseek
  • 创建一个deepseek API keys (访问 https://platform.deepseek.com/api_keys)

Cline插件安装

  1. 安装Cline插件
    在VSCode中打开扩展市场(Ctrl+Shift+X),搜索“Cline”并安装。安装完成后,VSCode左侧活动栏会出现一个机器人图标。
  1. 配置AI模型与API密钥
    点击Cline图标①,进入设置界面②。你需要配置一个AI模型提供商(API Provider)及其密钥(API Key)来驱动Cline。
  • 选择模型提供商 ③:Cline支持多种模型,如DeepSeek、Claude、OpenAI等。你可以选择免费的模型,例如通过OpenRouter提供商搜索并使用标记为“free”的模型(如deepseek-v3),或使用硅基流动等提供免费额度的服务。
  • 输入API密钥 ④:在对应位置填入你从所选模型提供商处获取的API密钥,然后保存设置。
  • 测试API是否正常

安装并配置GitHub MCP服务器

MCP服务器是扩展Cline能力的关键,它让Cline能够调用外部工具(这里是GitHub的API)。

  1. 进入MCP服务市场
    在Cline的界面中,找到并点击进入“MCP Servers”市场。
  2. 安装GitHub MCP服务器
    在MCP服务市场的搜索栏中搜索“GitHub”,找到后点击安装。安装过程通常由AI引导完成。
  3. 创建GitHub个人访问令牌(Personal Access Token)
    这是配置成功的关键,它授权MCP服务器访问你的GitHub账户。
  • 访问 GitHub Token设置页面(https://github.com/settings/tokens)。
  • 点击“Generate new token”(Classic)。
  • 为令牌设置一个描述性的名称(如Cline-MCP)。
  • 分配权限:为确保MCP服务有足够的权限进行操作,至少需要勾选以下范围的权限:repo(完全控制仓库)、workflow(可选,如需操作Actions)。
  • 生成令牌后,立即复制并妥善保存,因为关闭页面后将无法再次查看。
  1. 在Cline中完成令牌配置
  • 回到Cline的对话界面,AI会引导你输入刚刚创建的GitHub令牌。将复制的令牌粘贴到聊天窗口中,Cline会自动将其填充到生成的MCP服务器配置文件(如 cline_mcp_settings.json)中,然后保存即可。

注意:此配置过程本质上是在本地运行一个GitHub MCP服务器。确保你的电脑已安装Node.js环境,因为Cline可能会通过npx命令来运行@modelcontextprotocol/server-github这个npm包。

  1. 根据引导完成配置
  • 完成配置后会有绿色提示

使用Cline操作GitHub

配置成功后,你就可以通过自然语言指令让Cline帮你管理GitHub仓库了。

  • 查询仓库信息

你可以直接询问:“请列举一下我GitHub上有多少项目”。Cline会调用相应的MCP工具(如list_repositories, search_repositories)来获取信息。

  • 创建新仓库
    发送指令:“请帮我创建一个名为MCP-Test的公共仓库”。Cline会使用create_repository工具在你的GitHub账户下创建新仓库。
  • 推送代码到仓库
    这是一个常见的多步骤操作,如果遇到问题,Cline会尝试自动解决:
  1. 让Cline在本地创建文件:例如,“请为当前项目创建一个介绍MCP协议的index.html文件”。
  2. 提交代码到GitHub:指令如“请将当前项目中的所有文件推送到MCP-Test仓库”。
  3. 处理可能的问题:如果创建仓库时没有自动初始化分支,推送可能会失败。此时,Cline可能会先尝试使用create_or_update_file工具创建一个文件(如README.md)来初始化仓库和默认分支,然后再推送其他文件。
  • 管理分支与拉取文件
  • 创建分支:可以指令“在MCP-Test仓库中创建一个名为new-feature的新分支”。Cline会调用create_branch工具。
  • 拉取文件:可以说“将远程仓库MCP-Test中的README.md文件同步到本地”。Cline会使用get_file_contents工具获取文件内容并保存到本地。