Cherry Studio 项目中 MCP 服务器参数校验问题的技术分析

问题背景

在 Cherry Studio 项目的 1.1.17 版本中，用户报告了一个关于 MCP (Microservice Control Plane) 服务器添加功能的参数校验问题。从 1.1.13 版本开始，系统强制要求用户在添加 MCP 服务器时必须填写参数字段，这导致了一些不需要参数的 MCP 服务器(如 longport-mcp)无法正常添加。

技术细节分析

参数校验机制

该问题本质上是一个前端表单校验逻辑过于严格的问题。在 1.1.13 版本之前，参数字段是可选的，但在此版本后，开发团队可能出于数据完整性考虑，将参数字段设置为必填项。然而，这种变更没有考虑到所有 MCP 服务器的实际使用场景。

影响范围

这个问题主要影响以下几类用户：

1. 使用不需要参数的 MCP 服务器的用户
2. 希望通过配置文件管理 MCP 服务器配置的高级用户
3. 在自动化脚本中添加 MCP 服务器的开发者

临时解决方案

在官方修复发布前，用户可以尝试以下临时解决方案：

1. 在参数字段填写占位值(如"none")，然后在配置文件中手动删除
2. 直接编辑配置文件添加 MCP 服务器配置
3. 回退到 1.1.12 或更早版本

最佳实践建议

对于类似的项目参数校验设计，建议考虑以下几点：

1. 区分必填和可选字段，根据实际业务需求设计
2. 为不同类型的 MCP 服务器提供不同的添加模板
3. 在文档中明确说明每种 MCP 服务器所需的参数
4. 实现动态表单，根据选择的 MCP 服务器类型显示相应的必填字段

总结

这个案例展示了在软件开发中平衡数据完整性和用户体验的重要性。过于严格的校验虽然可以减少数据错误，但可能会限制合法的使用场景。Cherry Studio 团队需要重新评估 MCP 服务器添加功能的校验逻辑，找到更灵活的解决方案。