ModelContextProtocol C SDK 中的枚举序列化问题解析

在ModelContextProtocol的C# SDK开发过程中，我们遇到了一个关于枚举类型序列化的技术问题。这个问题主要影响了与MCP Inspector v0.6.0工具的交互兼容性。

问题的核心在于JSON序列化时枚举值的命名格式。默认情况下，C#中的枚举值会被序列化为PascalCase格式（即首字母大写），而现代前端工具和规范通常期望使用camelCase格式（即首字母小写）。这种格式不一致导致了MCP Inspector工具在获取提示信息时出现解析错误。

具体来说，当使用MCP Inspector工具执行以下操作时会出现问题：

1. 连接到运行中的ASP托管SSE实例
2. 列出提示信息
3. 选择特定提示并点击获取按钮
4. 系统会返回响应错误

问题的根源在于McpJsonUtilities.CreateDefaultOptions()方法中缺少对枚举序列化格式的明确配置。正确的解决方案是在创建JSON序列化选项时，明确指定使用camelCase命名策略：

Converters = { new JsonStringEnumConverter(JsonNamingPolicy.CamelCase) }

这个问题的出现反映了在跨平台、前后端分离架构中数据格式一致性的重要性。枚举作为常用的数据类型，其序列化格式在不同平台间的统一是保证系统互操作性的关键因素之一。

在实际开发中，类似的数据格式问题很常见，特别是在涉及多种编程语言和平台的系统中。开发者应当：

1. 明确制定项目的数据交换格式规范
2. 在序列化/反序列化配置中明确指定格式要求
3. 建立跨平台的集成测试机制
4. 在API文档中明确说明数据格式要求

通过这个案例，我们可以看到，即使是看似简单的枚举序列化格式问题，也可能导致系统间的交互失败。这提醒我们在系统设计阶段就需要考虑数据交换格式的统一性，并在实现阶段进行充分的测试验证。