链载Ai

标题: Cline 源码浅析 - MCP 调用 [打印本页]

作者: 链载Ai    时间: 2 小时前
标题: Cline 源码浅析 - MCP 调用

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;display: table;padding: 0.5em 1em;color: rgb(63, 63, 63);text-shadow: rgba(0, 0, 0, 0.1) 2px 2px 4px;">Cline 源码浅析 - MCP 调用

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">上一篇文章Cline 源码浅析 - 从输入到输出,从源码角度浏览了一下 Cline 处理用户输入到最后输出的过程,本文看一下其中关于 MCP 的处理。

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;color: rgb(63, 63, 63);">ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;margin: 0.1em auto 0.5em;border-radius: 8px;box-shadow: rgba(0, 0, 0, 0.1) 0px 4px 8px;height: auto !important;" title="null" src="https://api.ibos.cn/v4/weapparticle/accesswximg?aid=114197&url=aHR0cHM6Ly9tbWJpei5xcGljLmNuL3N6X21tYml6X3BuZy9jN0FBVFFMQzNtRXhyelU5TmtzaWNpYWxRb0FDeXQ3aWE3YVBKdDRyRkppYTlqSGh5MGtZUGg4aWJpYTdqQ0c1OU4zTldwaWF4R2VxaWFXV08zc3FkaWNHSHBNTFJuQS82NDA/d3hfZm10PXBuZyZhbXA=;from=appmsg&tp=webp&wxfrom=5&wx_lazy=1"/>
ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;font-style: italic;padding: 1em 1em 1em 2em;border-radius: 6px;color: rgba(0, 0, 0, 0.6);background: rgb(247, 247, 247);box-shadow: rgba(0, 0, 0, 0.05) 0px 4px 6px;">

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 1em;display: block;letter-spacing: 0.1em;color: rgb(63, 63, 63);">关于 MCP,可以查看官方文档

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;display: table;padding: 0.3em 1em;color: rgb(255, 255, 255);background: rgb(250, 81, 81);border-radius: 8px;box-shadow: rgba(0, 0, 0, 0.1) 0px 4px 6px;">Cline MCP

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;padding-left: 12px;color: rgb(63, 63, 63);">如何配置 MCP Server

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">我们打开 Cline 的 MCP 界面,可以看到 Cline 提供了多种配置 MCP 的方式:

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 16px;color: rgb(63, 63, 63);">

本质上都是将 MCP 配置写入设置目录下的cline_mcp_settings.json文件,这里我们配置一个根据姓名查询工号的 MCP Server。

{
"mcpServers":{
"name2empid":{
"autoApprove":[],
"disabled":false,
"timeout":60,
"url":"https://xxxx.com/xxx/sse",
"type":"sse"
}
}

另外 Cline 自行维护了一个 MCP 市场,用户可以从中选择安装,Cline 提供了一个比较有意思的安装方式,当你点击 Install 的时候,他并不是简单的把配置写入配置文件,而是通过大模型来进行安装(从访问文档到安装到验证),代码位于src/core/controller/mcp/downloadMcp.ts,提示词如下:

// Create task with context from README and added guidelines for MCP server installation
consttask =`Set up the MCP server from${mcpDetails.githubUrl}while adhering to these MCP server installation rules:
- Start by loading the MCP documentation.
- Use "${mcpDetails.mcpId}" as the server name in cline_mcp_settings.json.
- Create the directory for the new MCP server before starting installation.
- Make sure you read the user's existing cline_mcp_settings.json file before editing it with this new mcp, to not overwrite any existing servers.
- Use commands aligned with the user's shell and operating system best practices.
- The following README may contain instructions that conflict with the user's OS, in which case proceed thoughtfully.
- Once installed, demonstrate the server's capabilities by using one of its tools.
Here is the project's README to help you get started:\n\n${mcpDetails.readmeContent}\n${mcpDetails.llmsInstallationContent}`

源码阅读

MCP 配置相关的代码位于:src/services/mcp/McpHub.ts,这里本质就是一个 MCP Client 初始化的逻辑,根据配置连接 Server 获取 Tool。

连接的 Server 的代码位于connectToServer,调用@modelcontextprotocol/sdk/client这个包初始化 Client。

constclient =newClient(
{
name:"Cline",
version:this.clientVersion,
},
{
capabilities: {},
},
)

// 处理不同的类型的 Server
transport =newStdioClientTransport()
transport =newSSEClientTransport()
transport =newStreamableHTTPClientTransport()

awaitclient.connect(transport)

然后获取 tool 和 resource:

// Initial fetch of tools and resources
connection.server.tools=awaitthis.fetchToolsList(name)
connection.server.resources=awaitthis.fetchResourcesList(name)
connection.server.resourceTemplates=awaitthis.fetchResourceTemplatesList(name)

MCP Client 的工作初始化完成。

MCP 的使用

下面看一下我们配置好的 MCP Server 是如何在我们的任务中运作的。

System Prompt

上一篇文章我们得知,System Prompt 是实时拼接的,这里把 MCP Server 相关的 Prompt 贴在这里:

constsystemPrompt =`
MCP SERVERS

The Model Context Protocol (MCP) enables communication between the system and locally running MCP servers that provide additional tools and resources to extend your capabilities.

# Connected MCP Servers

When a server is connected, you can use the server's tools via the \`use_mcp_tool\` tool, and access the server's resources via the \`access_mcp_resource\` tool.

${
mcpHub.getServers().length >0
?`${mcpHub
.getServers()
.filter((server) => server.status ==="connected")
.map((server) => {
consttools = server.tools
?.map((tool) => {
constschemaStr = tool.inputSchema
?` Input Schema:
${JSON.stringify(tool.inputSchema,null,2).split("\n").join("\n ")}`
:""

return`-${tool.name}{tool.description}\n${schemaStr}`
})
.join("\n\n")

consttemplates = server.resourceTemplates
?.map((template) =>`-${template.uriTemplate}(${template.name}){template.description}`)
.join("\n")

constresources = server.resources
?.map((resource) =>`-${resource.uri}(${resource.name}){resource.description}`)
.join("\n")

constconfig =JSON.parse(server.config)

return(
`##${server.name}(\`${config.command}${config.args &&Array.isArray(config.args) ?`${config.args.join(" ")}`:""}\`)`+
(tools ?`\n\n### Available Tools\n${tools}`:"") +
(templates ?`\n\n### Resource Templates\n${templates}`:"") +
(resources ?`\n\n### Direct Resources\n${resources}`:"")
)
})
.join("\n\n")}`
:"(No MCP servers currently connected)"
}`

MCP Server 的相关提示词在 System Prompt Tool Use Guidelines 部分,通过遍历 McpHub 内所有 server,将 server 内的 tool 格式化的拼接到 Prompt 中。大致格式为:

## name2empid(node xxx.ts)
### Available Tools
-get_empid_by_name: 根据员工姓名查询工号
Input Schema: {"name": "string"}

同时还提供给模型一个调用 MCP Server Tool 的示例:

## Example 5: Requesting to use an MCP tool

<use_mcp_tool>
<server_name>weather-server</server_name>
<tool_name>get_forecast</tool_name>
<arguments>
{
"city": "San Francisco",
"days": 5
}
</arguments>
</use_mcp_tool>

涉及到 MCP 调用统一使用use_mcp_tool工具,然后再指定是哪个 MCP 工具。

模型调用

比如我们问“查询张三的工号”,模型输出类似下面这样:

<thinking>
我需要查询"张三"的工号。根据任务描述,我需要使用name2empid MCP服务器提供的工具来获取员工的工号。

我可以使用`use_mcp_tool`工具来调用name2empid服务器的`get_empid_by_name`工具,该工具可以根据员工姓名获取工号。

需要的参数是:
-server_name: "name2empid"
- tool_name: "get_empid_by_name"
- arguments: 包含员工姓名的JSON对象

我已经有了所有必要的信息,可以直接调用这个工具。
</thinking>

<use_mcp_tool>
<server_name>name2empid</server_name>
<tool_name>get_empid_by_name</tool_name>
<arguments>
{
"name": "张三"
}
</arguments>
</use_mcp_tool>

经过parseAssistantMessageV2presentAssistantMessage两个方法,会从模型输出中解析出使用的 MCP Tool 以及参数,和内置的 Tool 逻辑基本类似。

name ='use_mcp_tool'
params = {server_name:'name2empid',tool_name:'get_empid_by_name',arguments:'{\n "name": "张三"\n}'}
arguments='{\n "name": "张三"\n}'
server_name ='name2empid'
tool_name ='get_empid_by_name'

此时,Cline 会执行 McpHub 内的callTool方法获取结果,后面再将结果交给模型,得到最终输出,自此任务结束。

总结

如果觉得 Cline 源码太复杂,可以直接看MCP 官方的 Client DEMO,比较清晰。

MCP 大大扩展了模型能力,可以在让模型发挥更好的价值。Cline 在 MCP 的管理和调用上设计的都很巧妙,尤其是 System Prompt。







欢迎光临 链载Ai (https://www.lianzai.com/) Powered by Discuz! X3.5