1. 为什么要在 VS Code 里用 Cline 做 MCP 插件开发如果你最近在折腾 AI 编程工具大概率听过 MCPModel Context Protocol这个词。简单说它是一套让大模型能调用外部工具的协议——模型不再只是聊天而是能读文件、查数据库、发请求、跑命令。而 Cline 是 VS Code 里一个开源 AI 编程插件它原生支持 MCP 服务注册等于给你提供了一个现成的模型 ↔ 工具调度台。那为什么还要自己开发 MCP 插件因为现成的工具不一定贴合你的业务。比如你想让 AI 直接查公司内部的接口文档、操作某个私有 CLI、或者把日志按你的规则聚合这些都得自己写一个 MCP Server再挂到 Cline 上。这篇面向的是从零搭建可调试 MCP 插件骨架的入门场景你会拿到一份可复制的settings.json与config.toml配置片段走完 Cline 侧 MCP 服务注册步骤最后做一次本地调用验证把插件和模型通道的联调跑通。适合已经会写 TypeScript、装过 VS Code 插件、但对 MCP 协议还比较陌生的开发者。全程不需要你懂协议底层照着配置和命令走就行。我试过把模型通道统一收敛到一个 Key 上省得每个工具都去配一遍环境变量后面会具体讲怎么接。2. 前置准备TaoToken 统一 Key 与本地环境MCP 插件本身不绑定模型但你在 Cline 里调试时总得有个模型通道来响应工具调用。这里用 TaoToken 做统一入口好处是一个 Key 覆盖对话、编码、Agent 场景配置链路只维护一份。先去官网注册并拿到 API Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 后记下两个地址后面配置里会反复用到用途地址官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Basehttps://taotoken.net/api本地环境需要这些东西Node.js 18 以上MCP Server 官方 SDK 要求VS Code 1.84 以上Cline 插件在 VS Code 扩展市场搜 Cline 安装即可全局安装打包工具npm install -g vscode/vsce注意Cline 的 MCP 功能需要在设置里手动开启默认是关的。装完插件先去设置里把 Enable MCP 打开否则后面注册的服务不会出现在列表里。环境变量建议单独放一个文件别硬编码进代码。在项目根目录建.envTAOTOKEN_API_KEYsk-你的key TAOTOKEN_BASE_URLhttps://taotoken.net/api这样插件代码里用process.env.TAOTOKEN_API_KEY读取换 Key 不用改代码。3. 可复制配置settings.json 与 config.toml 片段这一节是核心直接给可复制的配置。分两块VS Code 侧的settings.json和 MCP Server 侧的config.toml。3.1 VS Code settings.json 片段打开命令面板CtrlShiftP输入 Open User Settings (JSON)把下面这段合并进去{ cline.mcp.enabled: true, cline.mcp.servers: { my-mcp-demo: { command: node, args: [${workspaceFolder}/dist/server.js], env: { TAOTOKEN_API_KEY: ${env:TAOTOKEN_API_KEY}, TAOTOKEN_BASE_URL: https://taotoken.net/api }, disabled: false, autoApprove: [read_file, list_dir] } } }几个关键字段说明commandargsCline 启动 MCP Server 的方式这里用 node 跑编译后的server.js。env把 Key 和 Base URL 注入子进程${env:...}是 VS Code 的变量替换语法从系统环境读。autoApprove白名单工具列进去的调用不需要每次手动确认调试时能省不少点击。注意autoApprove只放只读类工具涉及写文件、执行命令的别加进去不然调试时容易误操作。3.2 MCP Server config.toml 片段MCP Server 项目里建一个config.toml用来声明服务元信息和工具清单[server] name my-mcp-demo version 0.1.0 description 一个用于演示的 MCP 服务 [model] provider taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model claude-3-5-sonnet [[tools]] name read_file description 读取工作区内的文件内容 input_schema { type object, properties { path { type string } }, required [path] } [[tools]] name list_dir description 列出指定目录下的文件 input_schema { type object, properties { dir { type string } }, required [dir] }api_key_env指向环境变量名而不是直接写 Key这样配置文件可以进版本库Key 留在本地。3.3 项目骨架与依赖初始化项目mkdir my-mcp-demo cd my-mcp-demo npm init -y npm install modelcontextprotocol/sdk zod npm install -D typescript types/node npx tsc --inittsconfig.json里把outDir设成distrootDir设成src编译后 Cline 才能按dist/server.js找到入口。4. 在 Cline 侧注册 MCP 服务并本地验证配置写完了接下来是注册和验证。4.1 注册步骤第一步编译项目npx tsc确认dist/server.js生成。第二步回到 VS CodeCline 面板里点 MCP 图标通常在输入框上方会看到my-mcp-demo出现在服务列表里状态是绿色圆点表示已连接。如果没出现点一下刷新按钮或者重启 VS Code 窗口。第三步检查工具是否加载。在 Cline 的 MCP 面板里展开my-mcp-demo应该能看到read_file和list_dir两个工具。这一步很关键工具没加载出来后面调用一定失败。4.2 一次本地调用验证在 Cline 对话框里输入用 my-mcp-demo 的 list_dir 工具列出当前工作区根目录的文件Cline 会先请求模型判断该调哪个工具然后触发 MCP 调用。成功的话你会看到类似这样的返回{ content: [ { type: text, text: package.json\ntsconfig.json\nsrc\ndist\nconfig.toml } ] }同时 Cline 面板里会显示这次工具调用的耗时和状态。如果模型通道走的是 TaoToken你可以在 API Keys 页面看到对应的调用记录确认请求确实打到了统一入口。提示第一次调用可能会弹确认框因为list_dir在autoApprove里理论上不弹。如果弹了说明配置没生效检查settings.json的 JSON 格式有没有多余逗号。4.3 验证模型通道工具调用通了再验证一下模型通道本身。在 Cline 里问一个普通问题比如解释一下 MCP 协议的作用看是否能正常返回。这一步是确认 TaoToken 的 Key 和 Base URL 配置正确。如果工具能调但模型不响应多半是env里的 Key 没注入成功。5. 本篇常见错排查调试 MCP 插件时报错基本集中在几个地方我按出现频率排一下。服务列表里看不到 my-mcp-demo先确认cline.mcp.enabled是true再确认dist/server.js存在。如果路径用了${workspaceFolder}确保你是在项目根目录打开的 VS Code而不是打开了一个父目录。工具加载了但调用报 spawn node ENOENTCline 找不到 node 命令。在settings.json里把command改成 node 的绝对路径比如 Windows 下C:\\Program Files\\nodejs\\node.exe。调用返回 401 或 403Key 没注入。检查.env有没有被加载或者系统环境变量里有没有TAOTOKEN_API_KEY。VS Code 的${env:...}读的是系统环境不是.env文件两者别搞混。esbuild/win32-x64 未安装这是打包时常见的平台依赖缺失直接npm install esbuild/win32-x64补上即可。打包命令是vsce package成功后根目录会出现.vsix文件用code --install-extension xxx.vsix本地安装。模型响应超时先确认base_url是https://taotoken.net/api别多加斜杠或路径。再确认default_model写的是有效模型名。如果还是超时去 API Keys 页面看调用记录能定位是网络问题还是 Key 问题。改了 config.toml 但工具没更新MCP Server 是子进程改完配置要重启服务。在 Cline 的 MCP 面板里点对应服务的重启按钮或者直接重启 VS Code。6. 把配置链路固定下来跑通一次之后建议把配置链路固化别每次调试都手动改。我的做法是.env只放 Keyconfig.toml放模型和工具声明settings.json放启动参数三层各管各的。这样换模型只改config.toml换 Key 只改.env换启动方式只改settings.json。如果你后面要长期做编码类 Agent可以考虑用 Coding Plan 把额度固定下来避免调试时频繁换 Keyhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要管理多个 Key 或查看调用明细去控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentKey 的创建和轮换在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先在网页里验证模型通道是否正常用模型对话页最快https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句MCP Server 里涉及文件写入、命令执行的工具调试阶段别放进autoApprove等逻辑稳定了再逐步放开。插件骨架跑通只是起点真正花时间的是工具逻辑本身的设计——输入 schema 怎么定、错误怎么返回、超时怎么处理这些才是决定 MCP 插件好不好用的关键。