Waha Api MCP Server

🚀 OpenAPI MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器，它能读取 OpenAPI 规范文件，并将每个 API 操作作为工具提供给 Claude AI 使用，为 API 与 Claude AI 的交互搭建了桥梁。

🚀 快速开始

该服务器可快速集成到你的项目中，让 Claude AI 能使用 OpenAPI 定义的 API 操作。

✨ 主要特性

• 自动解析 OpenAPI YAML 文件，无需手动处理复杂的规范文件。
• 为每个 API 操作生成 MCP 工具，方便 Claude AI 调用。
• 处理路径参数、查询参数和请求正文，全面支持各种 API 调用场景。
• 当 Claude 使用这些工具时，实时调用相应 API，保证响应的及时性。
• 集成简便，可与 Claude Desktop 无缝对接，降低使用门槛。

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/openapi-mcp-server.git
cd openapi-mcp-server

# 安装依赖项
npm install

💻 使用示例

基础用法

1. 将你的 OpenAPI YAML 文件放在项目目录中，或通过环境变量提供其路径。
2. 配置环境变量（可选）：

# 创建 .env 文件
echo "DEBUG=true" > .env
echo "OPENAPI_FILE=./path/to/your/openapi.yaml" >> .env

3. 使用 Claude Desktop 初始化服务器：

npm run init

4. 或手动运行服务器：

npm start

高级用法

若 OpenAPI 规范文件如下：

paths:
  /users:
    get:
      operationId: listUsers
      summary: 列出所有用户
      ...

Claude 可以调用 listUsers 工具，服务器将代为发送对 /users 的 GET 请求。

📚 详细文档

配置

可以通过环境变量配置服务器：

• DEBUG：设置为 true 以启用调试日志（默认值：false）
• OPENAPI_FILE：OpenAPI YAML 文件的路径（默认值：./openapi.yaml）

工作原理

该服务器读取你的 OpenAPI 规范文件并执行以下操作：

1. 提取所有路径和操作。
2. 为每个操作创建工具，带有适当的输入模式。
3. 当 Claude 调用工具时，服务器会发送相应的 API 请求。
4. 响应返回给 Claude 进行分析。

📄 许可证

本项目采用 MIT 许可证。