ModelContextProtocol C SDK 中 JsonSchema 解析问题的分析与解决

在 ModelContextProtocol 的 C# SDK 开发过程中，开发团队发现了一个关于 JsonSchema 解析的重要问题。这个问题影响了与 FileSystem MCP 服务器的交互，特别是在处理数组类型参数时会出现解析不完整的情况。

问题背景

当开发者尝试调用 FileSystem MCP 服务器时，系统抛出了一个异常。经过分析，发现这是由于 SDK 在解析 JSON Schema 时未能正确处理数组类型的 items 属性导致的。具体表现为，当服务器返回包含数组参数的工具定义时，SDK 无法完整解析数组元素的类型定义。

问题复现

以一个实际的工具定义为例，服务器返回的 JSON Schema 中包含如下结构：

{
  "paths": {
    "type": "array",
    "items": {
      "type": "string"
    }
  }
}

理论上，这表示 paths 参数是一个字符串数组。然而，C# SDK 在解析时丢失了 items 部分的定义，导致后续的格式验证失败。

技术影响

这个解析缺陷会导致以下问题：

1. 无法正确验证客户端提供的数组参数类型
2. 可能导致向服务器发送格式错误的数据
3. 影响工具调用的可靠性和稳定性

解决方案

开发团队迅速响应，通过代码审查和测试，定位到了解析逻辑中的缺陷。修复方案主要涉及：

1. 完善 JSON Schema 解析器对数组类型的支持
2. 确保 items 属性能够被正确识别和解析
3. 添加相应的测试用例验证修复效果

经验总结

这个案例提醒我们，在实现协议解析器时需要特别注意：

1. 对 JSON Schema 各种复杂类型的全面支持
2. 边界条件的测试覆盖
3. 与服务器实现的严格一致性验证

通过这次问题的解决，ModelContextProtocol C# SDK 的稳定性和兼容性得到了进一步提升，为开发者提供了更可靠的开发体验。