面向 Cline 用户

Cline 先规划再动手。给规划一张地图。

Cline 会读文件、跑命令，改任何东西之前都会先问你。Maguyva 索引整个仓库并通过 MCP 返回结果，于是 Plan 模式从真实的调用点出发，而不是从目录列表出发。

Free 层级：3 个代码仓库, 最多 5 万行索引代码，无需信用卡。

.clinerules 管怎么做事，Maguyva 管代码现在怎么写。

关于 Cline 需要知道的

四条 Cline 专属事实。

// 配置文件

cline_mcp_settings.json

从 Cline 面板里的 MCP Servers 图标打开：先进 Configure 标签页，再点 Configure MCP Servers。服务器放在 mcpServers 下。

// 传输方式

远程，按 URL 连接

Cline 通过 Streamable HTTP 连接 Maguyva 的端点。没有本地进程，也不需要 Node.js。

// 密钥

直接写进请求头

和 Cline 自己的示例一样，密钥直接写进 Authorization 请求头。设置文件位于编辑器的用户存储中，不在你的仓库里。

// 类型

用 streamableHttp，不用 SSE

条目里保留 "type": "streamableHttp"：没有类型时，Cline 会当作旧式 SSE。把你信任的工具列进 autoApprove，就能跳过它们的批准提示。

Cline 规则是一份工作约定，好好用它。

# .clinerules/testing.md
- 把任务标记为完成之前，先跑测试套件。
- 添加依赖之前先询问。

工作区规则是放在 .clinerules/ 或 .cline/rules/ 中的 Markdown 文件；Cline 也会读取 AGENTS.md、.cursorrules 和 .windsurfrules。规则适合写：

Cline 应该运行的命令。
用 frontmatter glob 限定到某个路径的护栏。
你已经懒得一遍遍重复的团队约定。

规则告诉 Cline 该怎么做。它不会告诉 Cline，哪些服务在读它正要迁移的那张表。

规则和读文件不够用的地方

Cline 靠一次次请求、多读文件来填补的三个缺口。

// 从目录列表做出的规划

Plan 模式依据 Cline 目前读过的内容推理。在大仓库里，那不过是一棵目录树加几个文件，规划也就继承了这些缺口。

// 每次读取都是一次往返

Cline 为摸清情况打开的每个文件，都要花 token 和一次模型请求。在陌生的包里摸索，可能在第一次编辑前就用掉大半上下文窗口。

// 文本搜索找到的是字符串，不是调用方

“还有谁在调用它？”是一个图的问题。文本搜索能找到字符串，却分不清真正的调用方、注释、mock 和同名方法。

作为 Cline 中 MCP 服务器的 Maguyva

一条 mcpServers 条目让 Cline 获得：

面向已索引仓库的 11 个工具 语义、结构（AST）、图和文本搜索，外加符号查找、依赖方和文件检索。
带文件路径和行号的答案 覆盖 285+ 种语言，规划引用的都是真实存在的文件。
只读的工具 Maguyva 的工具只查询索引，没有一个会修改你的文件。

Cline 规则告诉 Cline 怎么工作。
Maguyva 给 Cline 一张用来规划的地图。

两种工作流

照着地图规划，然后执行。

// workflow 01

从真实调用点规划改动

cline plan> 把会话刷新移到 auth 包里

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ 进入 Act 模式之前，规划已列出三个调用点。
[exit 0]

规划会列出它要动的每个文件，你批准的是一份清单，而不是一个直觉。

// workflow 02

找到真正的实现，而不是测试夹具

cline> 我们的按比例计费是怎么算的？

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← 实现
  test/billing/proration.spec.ts:7   ← 夹具

→ Cline 只读一个文件，而不是六个。
[exit 0]

排序结果会把实现排在同名夹具之前。

在 Cline 中配置

三个步骤。Free 层级：3 个代码仓库, 最多 5 万行索引代码，无需信用卡。

// step 01

在 maguyva.ai 索引一个代码仓库

挑一个你已经熟悉的，这样你能给答案打分。

// step 02

把 Maguyva 添加到 Cline 的 MCP 设置

cline_mcp_settings.json

{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

// step 03

替换占位符，然后问一个问题

把 mgv_xxxx 换成你的 API 密钥并保存文件。问一个你已经知道答案的问题，然后打开它引用的文件。