Cline集成：开源AI编程工具的MCP实战

摘要Cline开源AI编程工具集成MCP Server实战详细讲解Cline的MCP配置、工具调用和自动化编程流程打造开源AI开发环境。第43篇 Cline集成 开源AI编程工具的MCP实战标签: MCP, Cline, 开源, AI编程, MCP集成前段时间有个读者私信我说他们公司预算有限买不起 Cursor Pro 也买不起 GitHub Copilot 订阅问我有没有免费的开源 AI 编程工具能支持 MCP。我说你试试 Cline这玩意儿完全开源装在 VS Code 里就能用而且 MCP 支持做得相当不错。我之前用了一个月踩了几个坑但也发现了不少惊喜今天就来聊聊。Cline 是什么Cline 最早叫 Claude Dev后来改名成了 Cline。它是一个 VS Code 扩展完全开源代码在 GitHub 上。它的核心能力是让 AI 模型Claude、GPT、DeepSeek 等都支持在 VS Code 里执行实际操作包括读写文件、运行终端命令、浏览网页等。跟 Cursor 和 Windsurf 这种独立 IDE 不同Cline 是寄生在 VS Code 里的扩展你不需要换编辑器装个插件就行。这对很多已经在用 VS Code 的开发者来说特别友好。Cline 对 MCP 的支持是它的一个亮点。它内置了一个 MCP 客户端能管理多个 MCP Server还有一个 Server 市场可以直接一键安装常用的 MCP Server。配置方式跟 Claude Desktop 类似但界面更友好。MCP 配置Cline 的 MCP 配置有两种方式。第一种是通过 Cline 的图形界面配置。在 VS Code 里打开 Cline 侧边栏点击 MCP Server 管理按钮一个服务器图标然后点 “Edit MCP Settings”。这会打开一个 JSON 配置文件路径一般在~/.cline/mcp_settings.json或 VS Code 的全局设置目录下。第二种是通过 Cline 的 Server 市场安装。点击 MCP Server 管理界面里的 “Marketplace” 按钮会弹出一个列表里面有很多社区维护的 MCP Server比如文件系统、GitHub、Puppeteer、Brave 搜索等。点击安装就会自动下载并配置好。下面是一个手动配置的完整示例。// cline_mcp_settings.json - Cline 的 MCP 配置文件 // 文件位置因系统而异通常在 ~/.cline/mcp_settings.json { mcpServers: { // 文件系统 Server让 Cline 能读写指定目录外的文件 filesystem: { command: npx, args: [ -y, modelcontextprotocol/server-filesystem, C:\\Users\\myname\\projects, // Windows 路径 C:\\Users\\myname\\Documents ], env: {}, disabled: false, // 是否禁用此 Server autoApprove: [] // 自动批准的工具列表不需要用户确认 }, // Git Server让 Cline 能执行 Git 操作 git: { command: uvx, args: [ mcp-server-git, --repository, C:\\Users\\myname\\projects\\myapp ], env: {}, disabled: false, autoApprove: [ git_status, // 自动批准 git_status 工具 git_log, // 自动批准 git_log 工具 git_diff // 自动批准 git_diff 工具 ] }, // 自定义的 CI/CD 查询 Server cicd: { command: node, args: [ C:\\mcp-servers\\cicd-server\\index.js ], env: { JENKINS_URL: https://ci.mycompany.com, JENKINS_TOKEN: 你的token }, disabled: false, autoApprove: [] } } }这里有个特别实用的字段叫autoApprove。Cline 在调用 MCP 工具的时候默认会弹出一个确认框让你批准。如果你把某个工具加到autoApprove列表里Cline 就会自动执行不需要你确认。我把只读的git_status、git_log、git_diff设成了自动批准写操作的git_commit保持手动确认这样既方便又安全。工具集成实战我给你们看一个实际的场景。我在项目里需要做一件事查看最近一周的 Git 提交记录根据提交内容生成一个变更日志然后自动提交这个日志文件。先写一个 Git MCP Server暴露几个常用的 Git 操作工具。// git-tools-server.ts - Git 操作 MCP Server for Cline// 依赖: npm install modelcontextprotocol/sdk simple-gitimport{Server}frommodelcontextprotocol/sdk/server/index.js;import{StdioServerTransport}frommodelcontextprotocol/sdk/server/stdio.js;import{CallToolRequestSchema,ListToolsRequestSchema,}frommodelcontextprotocol/sdk/types.js;importsimpleGitfromsimple-git;// 初始化 Git 实例指向项目目录// Cline 启动时会传入项目路径作为工作目录constgitsimpleGit(process.cwd());// 创建 MCP ServerconstservernewServer({name:git-tools-server,version:1.0.0},{capabilities:{tools:{}}});// 注册工具列表server.setRequestHandler(ListToolsRequestSchema,async(){return{tools:[{// 工具1: 获取最近 N 条提交记录name:git_recent_commits,description:获取最近 N 条 Git 提交记录包含 hash、作者、日期和提交信息,inputSchema:{type:object,properties:{count:{type:number,description:获取的提交数量默认 10,},since:{type:string,description:起始日期格式 YYYY-MM-DD例如 2025-01-01,},},},},{// 工具2: 获取当前 Git 状态name:git_status,description:获取当前 Git 仓库的状态包括暂存和未暂存的文件,inputSchema:{type:object,properties:{},},},{// 工具3: 提交代码name:git_commit,description:将所有已暂存的文件提交需要传入提交信息,inputSchema:{type:object,properties:{message:{type:string,description:提交信息,},},required:[message],},},{// 工具4: 获取两个 commit 之间的变更文件列表name:git_changed_files,description:获取两个 commit 之间发生变更的文件列表,inputSchema:{type:object,properties:{from:{type:string,description:起始 commit hash,},to:{type:string,description:结束 commit hash默认 HEAD,},},required:[from],},},],};});// 注册工具调用处理器server.setRequestHandler(CallToolRequestSchema,async(request){const{name,arguments:args}request.params;constargObj(args||{})asRecordstring,unknown;switch(name){casegit_recent_commits:{// 获取参数count 默认 10constcount(argObj.countasnumber)||10;constsinceargObj.sinceasstring|undefined;// 构建 git log 的参数constlogOptions:Recordstring,unknown{maxCount:count,format:{hash:%H,// 完整 hashauthor:%an,// 作者名date:%ad,// 作者日期message:%s,// 提交信息},};// 如果指定了起始日期添加 --since 参数if(since){logOptions[--since]since;}// 执行 git logconstlogawaitgit.log(logOptions);// 格式化输出constcommitslog.all.map((c)({hash:c.hash.substring(0,8),// 取前 8 位author:c.author,date:c.date,message:c.message,}));return{content:[{type:text,text:JSON.stringify(commits,null,2)},],};}casegit_status:{// 获取 Git 状态conststatusawaitgit.status();return{content:[{type:text,text:JSON.stringify({staged:status.staged,// 已暂存的文件modified:status.modified,// 已修改未暂存的文件untracked:status.not_added,// 未跟踪的文件current:status.current,// 当前分支},null,2),},],};}casegit_commit:{// 提交代码constmessageargObj.messageasstring;// 先添加所有变更到暂存区awaitgit.add(.);// 执行提交constresultawaitgit.commit(message);return{content:[{type:text,text:提交成功\n分支:${result.branch}\n提交信息:${message}\n变更文件数:${result.summary.changes},},],};}casegit_changed_files:{// 获取两个 commit 之间的变更文件constfromargObj.fromasstring;constto(argObj.toasstring)||HEAD;// 使用 git diff 获取变更文件列表constdiffawaitgit.diffSummary([from,to]);// 提取文件名和变更统计constfilesdiff.files.map((f)({file:f.file,insertions:f.insertions,// 新增行数deletions:f.deletions,// 删除行数}));return{content:[{type:text,text:JSON.stringify(files,null,2)},],};}default:thrownewError(未知工具:${name});}});// 启动 ServerconsttransportnewStdioServerTransport();awaitserver.connect(transport);自动提交代码场景配置好上面的 Git MCP Server 后在 Cline 里就可以做自动提交了。我在 Cline 聊天框里输入下面这段话。“帮我查看最近一周的 Git 提交记录然后根据提交信息生成一个变更日志文件 CHANGELOG.md格式按日期分组每个提交显示 hash 和 message。生成完后提交这个文件。”Cline 的执行过程是这样的。第一步调用git_recent_commits工具参数since设为一周前的日期。拿到提交记录列表。第二步Cline 自己分析提交记录按日期分组整理生成 Markdown 格式的变更日志内容。第三步Cline 用它内置的文件写入能力创建 CHANGELOG.md 文件。第四步调用git_commit工具提交信息设为 “docs: update CHANGELOG.md”。因为我没有把git_commit加到autoApprove里所以 Cline 会弹出一个确认框我点确认后才会执行提交。整个过程大概 30 秒完成如果手动做的话至少得 10 分钟。与商业工具对比我同时用了 Cline、Cursor 和 Windsurf 一段时间对它们做一个全面对比。对比维度Cline (开源)Cursor (商业)Windsurf (商业)价格完全免费$20/月起$15/月起安装方式VS Code 扩展独立 IDE独立 IDEMCP 配置JSON 文件 图形界面JSON 文件JSON 文件Server 市场有社区维护无无工具自动批准支持 autoApprove 字段不支持不支持模型支持Claude/GPT/DeepSeek 等内置模型内置模型工具调用确认可配置自动/手动默认自动默认自动文件操作通过 VS Code API内置编辑器内置编辑器终端命令执行支持需确认支持支持多文件编辑支持支持更流畅支持MCP 稳定性较好好偶有超时社区活跃度高GitHub 上很活跃闭源闭源自定义程度高可改源码低低Cline 最大的优势是开源和免费。你可以自己改它的源码来适配你的需求比如我之前就改过它的工具调用确认逻辑让某些工具在特定条件下自动执行。这个在 Cursor 和 Windsurf 里是做不到的。但 Cline 也有明显的短板。它没有自己的编辑器内核文件编辑是通过 VS Code API 实现的多文件批量编辑的体验不如 Cursor 流畅。另外它依赖你自己的 API Key如果你用 Claude 的 API按 token 付费的话重度使用一个月可能比 Cursor 订阅还贵。独家踩坑经验 autoApprove 导致意外提交代码这个坑差点让我把一段没写完的代码提交到主分支上现在想起来还后怕。事情是这样的我在配置 Cline 的 MCP 时为了方便测试把git_commit工具也加到了autoApprove列表里。当时想着这样能让 Cline 自动完成提交省得每次都要点确认。然后有一天我在 Cline 里让它帮我修复 src/utils/date.ts 里的时区 bug。Cline 改完代码后自作主张地调用了git_commit提交信息是 “fix: resolve timezone bug in date utils”。因为 autoApprove 了所以没有弹出确认框直接提交了。问题是我当时还在另一个文件里写了一半的代码那些未完成的改动也被git add .一起暂存并提交了。等我发现的时候主分支上已经有了一段写了一半的代码。更坑的是Cline 调用的git_commit工具里我写的是git.add(.)也就是添加所有变更。这跟 Cline 自己的文件操作是两套独立的系统Cline 改文件走的是 VS Code API而 Git MCP Server 走的是命令行 Git。两者之间没有协调所以 Git 不知道哪些是 Cline 改的、哪些是我手动改的。从那以后我学到了几个教训。第一永远不要把写操作的工具加到autoApprove里。只读操作可以自动批准写操作必须手动确认。第二Git MCP Server 里的git_commit不要用git add .应该只暂存特定文件。// 改进后的 git_commit 工具支持指定文件casegit_commit:{constmessageargObj.messageasstring;// 新增 files 参数指定要提交的文件constfiles(argObj.filesasstring[])||[.];// 只暂存指定文件而不是全部if(files.length0files[0]!.){// 逐个添加指定文件for(constfileoffiles){awaitgit.add(file);}}else{awaitgit.add(.);}constresultawaitgit.commit(message);// ... 返回结果}第三如果你在 Cline 里用 MCP 做 Git 操作最好先让 Cline 调git_status看一下当前有哪些变更确认没问题再提交。开源工具的优势和局限用了一个月 Cline 之后我对开源 AI 编程工具有了一些更深的认识。优势方面第一是透明度。Cline 的源码完全公开你能看到它到底怎么调用 MCP 工具的、怎么处理工具返回结果的。出了问题你可以直接看源码排查不像 Cursor 和 Windsurf 只能靠猜。第二是可定制性。你可以改 Cline 的源码来适配你的工作流。比如我改过它的 prompt 模板让它在调用 MCP 工具前先解释一下为什么要调这个工具这样我能更好地理解它的行为。第三是模型灵活性。Cline 支持多种 AI 模型你可以根据任务选择不同的模型。简单的任务用便宜的模型复杂的任务用贵的模型自己控制成本。局限方面第一是用户体验。Cline 的 UI 跟 Cursor 和 Windsurf 比还是有差距多文件编辑的体验不够流畅工具调用的展示也不够直观。第二是稳定性。因为是社区维护的偶尔会遇到一些小 bug。不过 Cline 的更新频率很高问题一般几天内就修了。第三是学习成本。Cline 需要你自己配 API Key、自己选模型、自己管理 MCP Server。对技术背景强的开发者来说不是问题但对新手来说门槛比 Cursor 高不少。小结这篇聊了 Cline 这个开源 AI 编程工具的 MCP 实战。几个要点。第一Cline 的 MCP 配置在~/.cline/mcp_settings.json支持 autoApprove 自动批准机制。第二只读工具可以加到 autoApprove写操作工具千万不要加。第三Git MCP Server 里的提交操作要支持指定文件不要无脑git add .。第四Cline 的优势是开源、免费、可定制劣势是 UX 和稳定性不如商业工具。如果你预算有限或者想深度定制 AI 编程工作流Cline 是个很好的选择。下一篇是本系列的压轴我们从零开始手写一个 MCP Client把前面用到的所有客户端的底层原理搞清楚。相关推荐Windsurf集成AI编程新贵的MCP支持自建MCP Client从零实现一个完整客户端Go SDK实战用Go语言开发高性能MCP Server