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 許可證。