ModelContextProtocol C SDK 中复杂参数对象的处理问题解析

问题背景

在使用ModelContextProtocol（MCP）C# SDK与语义内核（Semantic Kernel）集成时，开发者遇到了一个关于复杂参数对象处理的典型问题。当尝试将MCP客户端工具转换为语义内核的KernelFunction时，系统无法正确处理包含数组对象的复杂参数结构。

问题现象

开发者在使用memory-server MCP服务器时，通过McpClientFactory创建客户端并成功获取工具列表后，将工具导入语义内核。然而，当尝试保存数据时，系统报错"entities.filter is not a function"，表明参数处理出现了问题。

问题分析

通过检查请求负载发现，原本应该作为对象数组传递的entities参数被错误地序列化为JSON字符串。例如：

{
  "name": "create_entities",
  "arguments": {
    "entities": "[{\"name\":\"John Banana\"}]"
  }
}

而正确的负载应该是：

{
  "name": "create_entities",
  "arguments": {
    "entities": [
      {
        "name": "John Banana"
      }
    ]
  }
}

根本原因

这个问题源于语义内核在将工具转换为KernelFunction时，默认情况下不会保留原始参数类型信息。当参数包含复杂对象结构时，系统会将其序列化为字符串，而不是保持原有的对象结构。

解决方案

通过设置RetainArgumentTypes函数选择行为选项为true，可以解决这个问题。这个选项会指示系统保留参数的类型信息，确保复杂对象能够被正确序列化和传递。

var tools = await mcpClient.ListToolsAsync(new FunctionChoiceBehavior
{
    RetainArgumentTypes = true
});
kernel.ImportPluginFromFunctions("memory_server", tools.Select(a => a.AsKernelFunction()));

技术要点

1. 参数类型保留：在工具转换过程中，明确指定保留参数类型信息对于处理复杂数据结构至关重要。

2. 序列化行为差异：不同的序列化方式会导致完全不同的网络传输效果，开发者需要了解底层序列化机制。

3. 工具集成模式：当将外部工具集成到语义内核时，需要考虑参数传递的完整性和类型保真度。

最佳实践

1. 当集成MCP工具到语义内核时，始终设置RetainArgumentTypes为true
2. 对于包含复杂对象的参数，预先验证其序列化结果
3. 在开发阶段，使用日志记录完整的请求负载以便调试
4. 考虑为复杂参数类型创建明确的DTO（数据传输对象）

总结

这个问题展示了在AI工具链集成过程中类型系统处理的重要性。通过正确配置工具转换选项，开发者可以确保复杂数据结构在系统间传递时保持完整性和正确性。理解底层序列化机制和工具集成原理，有助于开发者构建更加健壮的AI应用系统。