waha
将OpenAPI规范自动转换为MCP工具,让Claude AI轻松调用API。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:waha。 它的用途是:将OpenAPI规范自动转换为MCP工具,让Claude AI轻松调用API。 完整的 Skill 内容见:https://321skill.com/skills/waha/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我查一下用户ID为123的最近订单状态。’,它会通过waha生成的MCP工具,自动调用你公司内部的订单查询API,并返回结构化的结果。或者,你可以说:‘将这条客户反馈内容标记为高优先级并创建工单。’,AI便能调用相应的客服系统API完成操作。
介绍
waha 是一个 MCP(Model Context Protocol)服务器,它解决了AI助手(如Claude)难以直接、安全地调用外部API的问题。通过解析标准的OpenAPI规范,它能自动生成对应的MCP工具,使AI能够理解和使用这些API,从而扩展其能力边界。
使用方式非常简单:用户只需提供目标API的OpenAPI规范文件(YAML或JSON格式),waha便会启动一个MCP服务器,并自动生成对应的工具。随后,在支持MCP的AI平台(如Claude Desktop)中配置该服务器地址,AI即可获得调用这些API的能力。
这个工具特别适合需要将现有API服务快速、安全地暴露给AI助手的开发者,尤其是那些希望让AI参与到业务流程中,进行数据查询、状态更新或自动化操作的全栈开发、后端开发和智能体开发者。
使用建议:在接入生产环境API前,建议先在测试环境充分验证生成工具的功能与安全性。注意,该工具依赖于API提供方规范的完整性和准确性,对于认证复杂或文档不规范的API可能需要额外处理。
核心特点
与手动编写MCP工具或使用通用API调用插件相比,waha的核心优势在于自动化:它能直接读取标准的OpenAPI规范并一键生成对应的MCP工具,无需开发者编写任何胶水代码,极大降低了将现有API服务接入AI工作流的门槛。
注意事项
对于认证机制复杂(如OAuth 2.0多步流程)、文档不规范或严重依赖动态参数的API,自动转换可能无法完美处理。
常见问题
waha支持哪些格式的OpenAPI规范?
支持OpenAPI 3.0及以上版本的YAML或JSON格式文件。
生成的工具安全吗?如何管理API密钥?
工具本身是安全的,但API密钥需在MCP服务器配置中妥善管理,避免泄露。建议使用环境变量或安全的密钥管理服务。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/waha/raw/index.md 读取 waha 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/waha/raw/index.md(查看排版版本)