MCP Inspector工具中整数类型参数传递问题的分析与解决

问题背景

在MCP Inspector工具的使用过程中，开发人员发现了一个与JSON Schema规范兼容性相关的问题。当MCP服务器定义了一个类型为"integer"的输入字段时，Inspector工具会错误地将其渲染为文本输入框，并将用户输入的值作为字符串传递给服务器，而不是按照JSON Schema规范要求的整数类型。

问题分析

这个问题本质上涉及JSON Schema规范中数字类型的处理差异。JSON Schema明确区分了"number"和"integer"两种类型：

• "number"类型可以表示任何数值，包括整数和浮点数
• "integer"类型专门用于表示整数

在MCP Inspector的早期版本中，工具只正确处理了"number"类型，而将"integer"类型错误地当作字符串处理。这种实现上的不一致会导致以下问题：

1. 类型安全性缺失：服务器期望接收整数却得到字符串
2. 数据验证失效：客户端未执行预期的整数验证
3. 潜在运行时错误：服务器端可能需要进行额外的类型转换

问题复现

通过Ruby实现的MCP服务器可以清晰地复现这个问题。当服务器定义如下工具时：

tool 'square' do
  description 'square an int'
  argument :num, Integer, required: true, description: 'the integer to square'
  call { |num:| num**2 }
end

对应的JSON Schema会包含"integer"类型定义：

{
  "type": "object",
  "properties": {
    "num": { "type": "integer", "description": "the integer to square" }
  },
  "required": ["num"]
}

在Inspector工具中，用户输入数值后，服务器实际接收到的却是字符串类型，导致运算失败。

解决方案

开发团队通过以下步骤解决了这个问题：

1. 类型识别增强：在表单渲染逻辑中，明确区分"number"和"integer"类型
2. 输入控件优化：为整数类型提供专门的数字输入控件
3. 数据转换处理：在提交数据前，将用户输入正确转换为对应的JSON类型
4. 验证逻辑完善：添加对整数输入的验证规则

解决方案的核心在于正确处理JSON Schema规范中的类型定义，并确保客户端与服务端之间的类型一致性。

测试验证

为确保修复的有效性，开发团队增加了针对性的测试用例：

1. 单元测试验证表单对"integer"类型的正确渲染
2. 集成测试验证整数参数的完整传递流程
3. 边界测试验证各种整数输入情况（包括大整数、负数等）

版本发布

该修复已包含在MCP Inspector的0.7.0版本中。用户可以通过更新到最新版本来获取这一改进。

总结

这个问题展示了在实现JSON Schema支持时需要特别注意的类型系统细节。MCP Inspector团队通过这个问题修复，不仅解决了具体的整数传递问题，还增强了工具整体的类型处理能力，为开发者提供了更符合规范的开发体验。

对于开发者而言，这一改进意味着：

• 更准确的类型检查
• 更可靠的参数传递
• 更好的规范兼容性

这也提醒我们在实现协议工具时，对规范细节的精确理解至关重要。