发帖
 找回密码
 立即注册
搜索
5 3 0
资源分享 88 5 7 小时前
1. 基于 openai 接口规范tools 字段
这个方法要求大模型的服务商的服务器支持了 openai 接口规范,这个在我的 openmcp 文档里写得很清楚:MCP Basic Concepts。目前大部分的大模型服务商几乎都是支持 openai 接口规范的,然后这个接口规范里面有一个字段叫做 tools,MCP 客户端会把 MCP 服务器提供的函数服务使用一种特殊格式塞到这个 tools 字段里面。然后当你问问题的时候,问题和 tools 会一起塞到大模型里面,这个 tools 会被大模型厂商内部的程序构造成一种特殊的 system prompt,然后大模型会返回本地的消息,返回的消息里面有两个东西,content 和 tool_calls 数组。
content 就是大模型在本轮对话中的返回的文本,tool_calls 数组代表大模型想要调用的工具。
比如下图中,① 就是 content,② 就是 tool_calls(此处调用了把网页转换成 markdown 的 mcp),它们都是一次返回的结果。
a2a7188e5d1a36ff0a036c511a62aa72c78f61b6.webp
如果输入的 tools 为空数组,也就是你们平时使用的网页版本的大模型,那么返回的 tool_calls 一定为空。
显然,这个方法它要求服务商支持 openai 接口规范,而且还支持了 tools 字段。几乎所有厂商都支持 openai 接口规范,但是支持 tools 字段的模型大概只有 70% 左右。官方 deepseek r1 也是最近才刚刚支持的 tools 字段(火山云的 deepseek r1 很早就支持 tools 了)
顺带一提,如果你塞入了 7 个 MCP 服务器,每一个 MCP 服务器提供 7 个 tool,那么每一次询问的 tools 数组长度就是 49.
再顺带一提,目前大部分厂商支持的 tools 数组长度上限为 100

2. 利用 xml 进行指令包裹
这时有小伙伴就要问了:那么如果大模型的服务商没有支持 tools 咋办哩?为什么 cherry studio 等客户端可以做到就算大模型厂商不支持,也能调用工具呢?
这就涉及到我讲的第二个方法了,利用 xml 进行指令包裹。这个方法最早是谁想
到的我暂时无从得知,但是要想到也不是很难。它的做法大致做法如下:
  • 手写一个很长的 system prompt,告诉大模型如果你想要进行工具调用,把想要调用的工具的名字和参数包括在 xml 标签里面。
  • 在 system prompt 结尾罗列目前所有的 mcp 的工具。
  • 当用户输入的问题,大模型返回文本结果时,检查大模型返回的文本,把里面的  给提取出来,然后去解析这个 xml 代码,从而得到一段结构化的对象,如果这个对象里面包含了正确的 mcp tool 和 参数,就去调用这个 mcp tool。
  • 将 mcp server 返回的结果作为结果重新返回给大模型。
  • 如果大模型返回的内容中还有 xml,那么重复第三步,否则,停止任务循环。
这里给大家一个可以执行上述操作的 system prompt:(从 SuperAssistant 这个项目里面扒出来的)
  1. [从这里开始新会话]
  2. <系统>
  3. 您是一个名为SuperAssistant的智能助手,具备调用功能函数的能力,并能在协助过程中充分利用这些功能。您是一个知识渊博的助手,专注于回答各类问题并提供相关信息。
  4. 在当前环境中,您可以使用一组工具来回答用户的问题。
  5. 您可以调用一组功能函数来回答用户的问题。目前您不具备检查文件或与外部资源交互的能力,除非通过调用以下函数。
  6. 函数调用结构:
  7. - 所有函数调用必须用```xml ... ```这样的'xml'代码块标签包裹。这是严格要求。
  8. - 所有函数调用必须包含在'function_calls'标签中
  9. - 每个函数调用使用带有'name'属性的'invoke'标签
  10. - 参数使用带有'name'属性的'parameter'标签
  11. - 参数格式:
  12. - 字符串/标量参数:直接写入值
  13. - 列表/对象:必须使用正确的JSON格式
  14. - 必须始终包含必需参数
  15. - 可选参数仅在需要时包含
  16. - 如果参数值中包含xml,不要使用CDATA包裹,直接给出xml
  17. 关于'invoke'的说明:
  18. - 调用函数时,使用带有'name'属性的'invoke'标签指定函数名
  19. - invoke标签必须嵌套在'function_calls'块中
  20. - 函数参数应作为'parameter'标签包含在invoke标签内,每个parameter标签都有'name'属性
  21. - 必须包含每个函数调用的所有必需参数,可选参数仅在需要时包含
  22. - 字符串和标量参数应直接指定为值,而列表和对象应使用正确的JSON格式
  23. - 直接与用户交流时不要提及函数/工具名称 - 关注我正在做什么而非使用的工具
  24. - 调用函数时,确保提供所有必要的上下文以使函数正确执行
  25. - 每个'invoke'标签应表示一个完整且独立的函数调用及其相关参数
  26. - 在思考/推理过程中不要生成任何标签,因为这些会被解释为函数调用并执行。只需制定正确的函数调用参数。
  27. 关于'call_id="$CALL_ID"'的说明:
  28. - 这是函数调用的唯一标识符
  29. - 这是一个数字,从1开始,每个新函数调用递增1
  30. 您可以通过在回复用户时写入如下""块来调用一个或多个函数,确保每次只调用一个函数,即在输出中只包含一个''标签:
  31. <示例>
  32. ```xml


  33. $PARAMETER_VALUE
  34. $PARAMETER_VALUE
  35. ...


  36. ```
  37. 字符串和标量参数应按原样指定,而列表和对象应使用JSON格式。注意字符串值的空格不会被去除。输出不需要是有效的XML,而是通过正则表达式解析。
  38. 当用户提出请求时:
  39. 1. 始终分析哪些函数调用适合该任务
  40. 2. 始终严格按照模式格式化函数调用
  41. 3. 永远不要在函数调用中跳过必需参数
  42. 4. 永远不要编造不可用的函数
  43. 5. 始终等待函数调用执行结果后再继续
  44. 6. 调用函数后,等待标签中的输出,然后再继续响应
  45. 7. 永远不要在一个响应中调用多个函数
  46. 8. 永远不要模拟或自行形成,它将在执行后提供给您
  47. 使用相关工具(如果可用)回答用户的请求。检查每个工具调用所需的所有参数是否已提供或可以从上下文中合理推断。如果没有相关工具或缺少必需参数值,请要求用户提供这些值;否则继续执行工具调用。如果用户为参数提供了特定值(例如用引号提供的值),请确保完全使用该值。不要为可选参数编造值或询问可选参数。仔细分析请求中的描述性术语,因为它们可能表示应包含的必需参数值,即使没有明确引用。
  48. <输出格式>
  49. <从这里开始>
  50. ## 思考
  51. - 用户查询阐述:
  52. - 思考:
  53. - 观察:
  54. - 解决方案:
  55. - 要使用的函数:
  56. - call_id: $CALL_ID + 1 = $CALL_ID

  57. ```xml


  58. $PARAMETER_VALUE
  59. $PARAMETER_VALUE
  60. ...


  61. ```
  62. <到此结束>

  63. 不要在输出中使用<从这里开始>和<到此结束>,这只是输出格式的参考,指示从哪里开始和结束输出。
  64. ## SUPERASSISTANT可用工具
  65. - neo4j-mcp[](https://zhida.zhihu.com/search?content_id=731749879&content_type=Answer&match_order=1&q=neo4j-mcp&zhida_source=entity).executeReadOnlyCypherQuery
  66. **描述**: [neo4j-mcp] 执行只读的Cypher查询
  67. **参数**:
  68. - `cypher`: Cypher查询语句,必须是只读的 (字符串) (必需)
  69. - neo4j-mcp.getAllNodeTypes
  70. **描述**: [neo4j-mcp] 获取所有节点类型
  71. - neo4j-mcp.getAllRelationTypes
  72. **描述**: [neo4j-mcp] 获取所有关系类型
  73. - neo4j-mcp.getNodeField
  74. **描述**: [neo4j-mcp] 获取节点字段
  75. **参数**:
  76. - `nodeLabel`: 节点标签 (字符串) (必需)
  77. - list_servers
  78. **描述**: 列出所有连接的MCP服务器及其功能
  79. - get_server_info
  80. **描述**: 获取特定服务器的详细信息
  81. **参数**:
  82. - `serverName`: 要获取信息的服务器名称 (字符串) (必需)

  83. 用户交互从这里开始:
复制代码
当每次 mcp 客户端激活的时候,你都需要通过程序来构造出 ## SUPERASSISTANT可用工具 这个部分的描述内容。


在 deepseek 中调用 mcp 访问这个私人数据库:
e483e9f60ca26cf4cb73548d97bf325a62bd804d.webp
当然,你看到的各类形形色色的 MCP 客户端,比如 cherry studio 都是基于这个方法实现的。

这个OpenMCP则是基于第一种方法实现,本周我也会让 OpenMCP 兼容第二种方法,让你可以在两种方法中调换你的任务循环驱动器的内核实现,做出鲁棒性更强的 mcp agent。
-
方法一 vs 方法二
虽然方法二能实现,但是毕竟是野路子,并不是正规军,方法二存在如下的问题:
  • 得到的 xml 不一定严格遵循 mcp tool 的描述,而且也不一定可被解析,这让调用成功率下降。
  • 因为是基于用户的 system prompt 实现的(大模型厂商内部其实还有一个 system prompt,我们写的 system prompt 其实是 development prompt),如果大模型的 needle in a haystack(大海捞针,指大模型从海量上下文中寻找指代和问题关键词的能力) 能力不行,那么这种方法在对话变长后,调用工具的频次和 xml 生成的精度就会下降。

方法二也是有好处的,除了兼容性很棒外,自己部署的大模型也能玩 mcp 外,方法二可以在每次调用工具前给出推演过程,视觉效果比较好


──── 3人觉得很赞 ────

使用道具 举报

这样的知识多发,爱看
方法一和方法二一起用的会不会冲突?因为按照理论上来说方法一是模型的基本能力,方法二则是对模型的应用,如果都可以使用会不会有问题?
peterll
7 小时前
会的,尽量别一起用,这两个方法就好比两个不同的网络协议,不能混在一起。  详情 回复
7 小时前
guojun_-2007 发表于 2025-6-26 09:59
方法一和方法二一起用的会不会冲突?因为按照理论上来说方法一是模型的基本能力,方法二则是对模型的应用, ...

会的,尽量别一起用,这两个方法就好比两个不同的网络协议,不能混在一起。
Cline就是玩这一套,纯提示词驱动,感觉效果还不错,即使费token
看下来感觉方法一更稳定可靠
您需要登录后才可以回帖 立即登录
高级模式