Cline 加 Brave Search MCP：搜完写成 Markdown

在 VS Code 里用 Cline 写技术文时，最烦的是模型训练数据过期：库版本、报错信息、官方文档路径，经常和现状对不上。给 Cline 接上 Brave Search MCP 之后，它可以先搜网页，再把结果整理成 Markdown，整条链路都在编辑器里完成。

你需要准备什么

已安装 Cline（见 docs.cline.bot MCP 文档；VS Code / Cursor 扩展或 CLI）
本机有 Node.js（走 npx 启动 MCP）
一把 Brave Search API Key（brave.com/search/api 控制台申请，Search 套餐有免费额度）

社区早期包也能用，但官方包工具更全。下面以官方包为主。

在 Cline 里加上 Brave Search

1. 打开 MCP 配置

在 Cline 面板点 MCP Servers 图标，进 Configure，再点 Configure MCP Servers，会打开扩展用的 JSON。常见文件名类似 cline_mcp_settings.json。CLI 用户可改家目录下 .cline/mcp.json，或跑 cline mcp 向导。

2. 写入本地 STDIO 服务

把下面这段加到 mcpServers 里（Key 换成你自己的，不要提交到 Git）：

json

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

说明几点：

传输选 stdio 适合本机编辑器；HTTP 是另一套，Cline 本地进程用 stdio 更省事。
Windows 上若 npx 起不来，可改成 cmd 加 /c，或直接指向本机 node 和包入口。
autoApprove 先留空，让 Cline 每次调搜索前弹确认；用熟了再按需放开。

3. 确认工具已出现

保存配置后，Cline 会拉起进程。面板里应能看到 brave_web_search、brave_news_search、brave_llm_context 等工具。连不上就检查：Key 是否有效、Node 是否在 PATH、进程日志有没有报错。

搜完直接写成 Markdown

接好之后，核心用法就一句话：让 Cline 先调 Brave 搜，再按你指定的结构落盘成 md 文件。

可以这样下指令（按自己主题改）：

text

用 Brave Search 查「某库最新实践」近一年的资料。
先 web search 拿 8 到 10 条结果，必要时再用 news search。
然后在当前仓库 docs 下写一篇中文 Markdown：开头说明场景，二级标题组织要点，文末列引用链接。
不要编造没搜到的 API。

工作流大致是：

Cline 调用 brave_web_search（可加 freshness，比如 py 限一年内）
需要更贴模型的摘录时，用 brave_llm_context
你批准工具调用后，它读摘要、比对冲突信息
在工作区新建或改写 Markdown 文件

写博客、更新 README、整理周报、把讨论收成文档，都适合这条路径。

几个实用技巧

收窄结果：freshness 用 pd / pw / pm / py；count 先小一点，避免一次灌太多上下文。

先搜再写，分两轮。第一轮只列候选链接和一句话摘要，确认后再写成文章。

Key 别写进仓库。用环境变量或本机 MCP 配置；分享项目时只提交不含 Key 的示例。

配额要心里有数。Brave Search API 按请求计费，免费额度用完会失败。

也可和文档类 MCP、文件系统一起用：Brave 找资料，文档 MCP 读官方 API，最后落盘。

出问题时怎么查

工具列表是空的：重启 MCP，确认 npx 能单独跑通，检查 JSON 括号。
Auth 或 401：重新复制 Key，确认环境变量名是 BRAVE_API_KEY。
超时：调高 Cline 的 MCP timeout，或先关掉其它占资源的 MCP。
结果又旧又偏：加 freshness，换更具体的 query，必要时再用 news 或 llm context。

小结

Cline 负责改文件和对话，Brave Search MCP 负责实时网页检索。配好 Key 和一段 mcpServers 配置之后，就可以在编辑器里完成「搜、核对、写成 Markdown」的闭环。

参考链接：