ModelContextProtocol C SDK中JSON内容类型处理的最佳实践

在使用ModelContextProtocol（MCP）C# SDK开发AI工具时，开发者可能会遇到"Unsupported content type: application/json"的错误提示。本文将深入分析这一问题的技术背景，并提供完整的解决方案。

问题本质分析

当通过Claude Desktop调用MCP服务时，如果工具方法返回的Content对象中设置了"application/json"类型，系统会抛出内容类型不支持的异常。这是因为MCP协议和AI客户端对内容类型的支持存在特定限制。

MCP协议内容类型规范

MCP协议明确规定，Content对象的Type属性仅支持以下几种值：

1. "text" - 普通文本内容
2. "image" - 图像数据
3. "audio" - 音频数据
4. "resource" - 资源类型（可附带MIME类型说明）

"application/json"不属于上述支持的基础类型，因此直接使用会导致错误。

解决方案比较

开发者可以采用以下几种方式返回JSON数据：

方案一：直接返回文本类型

return new[]
{
    new Content
    {
        Type = "text",
        Text = JsonSerializer.Serialize(response.Strategies)
    }
};

方案二：使用资源类型并指定MIME

return new[]
{
    new Content
    {
        Type = "resource",
        MimeType = "application/json",
        Text = JsonSerializer.Serialize(response.Strategies)
    }
};

方案三：直接返回序列化字符串

return JsonSerializer.Serialize(response.Strategies);

方案四：直接返回对象

return response.Strategies;

各方案适用场景分析

1. 方案一是最通用的解决方案，兼容所有主流AI客户端（包括Claude、Gemini、GPT等）
2. 方案二理论上更规范，但需要客户端支持资源类型的解析
3. 方案三和四最为简洁，SDK会自动处理序列化和内容类型

性能与兼容性考量

经过实际测试验证：

1. 当前版本的Claude Desktop仅完全支持"text"和"image"类型
2. 多部分内容（Content数组）与拼接文本在功能上等效
3. JSON格式虽然AI能理解，但并非必需，简单文本也能获得良好效果

最佳实践建议

1. 对于简单工具方法，直接返回对象或字符串是最佳选择
2. 只有在混合内容类型（如图文结合）时才需要使用Content数组
3. 生产环境中应通过评估测试确定最优的返回格式
4. 缓存控制等高级功能需要自定义属性和客户端支持

结论

理解MCP协议的内容类型规范对于开发稳定的AI工具至关重要。在大多数情况下，直接返回文本或对象是最简单可靠的解决方案。开发者应根据目标AI平台的特性和项目需求，选择最适合的内容返回策略。

通过遵循这些最佳实践，开发者可以避免内容类型相关的错误，同时确保工具方法与各种AI客户端的良好兼容性。