ModelContextProtocol C SDK 中可选参数问题的分析与解决方案

问题背景

在使用 ModelContextProtocol (MCP) 的 C# SDK 开发过程中，开发者发现了一个关于函数可选参数的有趣问题。当尝试在工具方法中使用可选参数时（例如 string? date = null），客户端仍然将这些参数标记为必填项，这与 C# 语言本身的特性不符。

问题分析

经过深入调查，发现问题根源在于 JSON Schema 的生成机制。SDK 内部使用的 JsonSchemaCreateOptions 默认将 RequireAllProperties 设置为 true，这导致无论 C# 方法参数是否声明为可选，生成的 schema 都会将所有参数标记为必需。

临时解决方案

开发者提出了一个临时解决方案，通过修改 CreateAIFunctionFactoryOptions 方法中的 JsonSchemaCreateOptions 配置：

JsonSchemaCreateOptions = new AIJsonSchemaCreateOptions()
{
    RequireAllProperties = false
}

这种方法虽然有效，但需要直接修改 SDK 源代码，不是理想的长期解决方案。

官方解决方案

微软扩展团队最近在相关依赖库中合并了一个重要变更，将 RequireAllProperties 的默认值改为 false。这意味着：

1. 未来版本的 MCP SDK 将自动正确处理可选参数
2. 开发者不再需要手动修改配置
3. 函数参数的可选性将完全遵循 C# 语言的语义

最佳实践建议

在等待官方更新期间，开发者可以采用以下方法：

1. 使用 McpServerTool.Create 方法显式传递 AIJsonSchemaCreateOptions
2. 创建自定义的 WithTool 扩展方法，覆盖默认行为
3. 对于简单场景，可以考虑使用重载方法替代可选参数

总结

这个问题展示了框架设计与语言特性之间的微妙关系。随着微软扩展库的更新，MCP C# SDK 将能更好地支持 C# 语言特性，提供更符合开发者预期的行为。对于当前项目，开发者可以根据项目紧急程度选择临时解决方案或等待官方更新。