Orval v7.9.0 发布：新增 mcp 客户端支持与多项功能优化

Orval 是一个强大的 API 客户端生成工具，它能够根据 OpenAPI/Swagger 规范自动生成类型安全的 API 客户端代码。最新发布的 v7.9.0 版本带来了多项重要更新和改进，包括对新客户端类型的支持、表单数据处理优化、枚举类型增强等。

新增 mcp 客户端支持

本次更新最引人注目的特性是新增了对 mcp 客户端的支持。mcp 是一种新兴的 API 客户端实现方式，Orval 现在能够为使用 mcp 的项目生成适配的客户端代码。开发团队还专门为此添加了测试用例和示例应用，帮助开发者快速上手。

表单数据处理优化

在处理表单数据特别是数组类型时，v7.9.0 提供了更好的支持。这项改进使得开发者能够更轻松地处理包含数组的复杂表单数据，特别是在文件上传等场景下，表单数据的生成和传输更加准确可靠。

枚举类型增强

新版本引入了联合枚举(union enum)的生成能力。这意味着当 API 规范中定义了联合类型的枚举值时，Orval 能够生成更精确的类型定义，提供更好的类型安全性和开发体验。这项改进特别适合那些需要处理多种可能值的 API 接口。

查询功能增强

对于使用 React Query 的开发者，v7.9.0 带来了多项查询相关的改进：

• 新增了对 suspenseQuery 和 suspenseInfiniteQuery 的 prefetch 支持
• 修复了查询参数语法生成的问题
• 优化了查询和突变操作的生成逻辑
• 解决了 Vue Query 中 useCallback 未定义的问题

其他重要改进

1. 路径处理优化：现在会正确包含 baseUrl 和 servers 设置到路由路径中
2. 代码生成优化：只导入必要的 schema，减少生成代码的体积
3. 自定义 Mock 支持：允许开发者定义自定义的 mock 生成器
4. PNPM 支持：新增对 PNPM 包管理器的 catalog 支持
5. 操作名称处理：修复了覆盖操作名称时的 sanitize 问题

开发者体验提升

除了功能上的改进，v7.9.0 还包含多项开发者体验的优化：

• 更新了文档，包括新增的 mcp 客户端指南
• 修复了示例项目中的问题
• 更新了贡献指南
• 解决了多项依赖安全问题

总结

Orval v7.9.0 通过新增 mcp 客户端支持、优化表单数据处理、增强枚举类型生成等多项改进，进一步提升了 API 客户端生成的灵活性和可靠性。这些变化使得 Orval 能够更好地适应各种开发场景，为开发者提供更强大的工具支持。无论是新项目还是现有项目升级，v7.9.0 都值得考虑。