Waha MCP

🚀 WAHA MCP Server

WAHA MCP Serverは、強力なWAHA (WhatsApp HTTP API) とClaude DesktopなどのAIアシスタントを橋渡しし、Model Context Protocol (MCP) を通じてシームレスなWhatsApp自動化を可能にします。

ドキュメント • インストール • 設定 • 🤖 Claude Codeのセットアップ • ツールリファレンス

🚀 クイックスタート

WAHA MCP Serverは、強力なWAHA (WhatsApp HTTP API) とClaude DesktopなどのAIアシスタントを接続し、Model Context Protocol (MCP) を通じてシームレスなWhatsApp自動化を実現します。

✨ 主な機能

• 📱 完全なWhatsAppコントロール - メッセージの送受信、チャットの管理、グループの作成が可能
• 🎯 63のツール - セッション、メッセージング、連絡先、グループ、インタラクティブワークフローなど、包括的なAPIカバレッジ
• 🔄 スマートメディア処理 - 音声/ビデオの自動変換、URLとローカルファイルのサポート
• 🤖 AIネイティブ - MCPを介したLLM統合に特化して構築
• 🔒 セキュア - 環境ベースのAPIキー管理
• ⚡ 高速かつ信頼性高い - TypeScriptで動作し、堅牢なエラーハンドリングを備える

📋 前提条件

始める前に、以下が必要です。

• Node.js 18以上 - ここからダウンロード
• 動作中のWAHAインスタンス - セットアップガイド
• WAHA APIキー - WAHAダッシュボードから生成

📦 インストール

1. クローンとインストール

git clone https://github.com/dudu1111685/waha-mcp.git
cd waha-mcp
npm install
npm run build

2. 環境変数の設定

.envファイルを作成するか、変数をエクスポートします。

export WAHA_API_KEY="your-api-key-here"
export WAHA_URL="http://localhost:3001"  # オプション、デフォルトはlocalhost:3001

⚙️ 設定

Claude Desktop

claude_desktop_config.jsonに追加します。

• Linux: ~/.config/claude/claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "waha": {
      "command": "node",
      "args": ["/absolute/path/to/waha-mcp/dist/index.js"],
      "env": {
        "WAHA_API_KEY": "your-api-key-here",
        "WAHA_URL": "http://localhost:3001"
      }
    }
  }
}

Cline / VS Code

Cline MCP設定 (~/.vscode/mcp.json またはワークスペース設定) に追加します。

{
  "mcpServers": {
    "waha": {
      "command": "node",
      "args": ["/absolute/path/to/waha-mcp/dist/index.js"],
      "env": {
        "WAHA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code (自律的開発)

🤖 本格的な自律的AI開発を有効にする: Claudeがユーザー入力を必要とするときに停止する代わりに、WhatsAppを介して質問をし、作業を続けることができます！

🚀 完全なセットアップガイド:

クイック設定例:

{
  "mcpServers": {
    "waha": {
      "command": "node",
      "args": ["/path/to/waha-mcp/dist/index.js"],
      "env": {
        "WAHA_API_KEY": "your-key",
        "USER_WHATSAPP_CHAT_ID": "1234567890@c.us"
      }
    }
  },
  "globalInstructions": "開発中にユーザー入力が必要な場合は、ask_user_via_whatsappツールを使用してください。手動でのコンソール入力を待って停止しないでください。"
}

動作原理:

1. Claudeが質問に直面する → WhatsAppを介して質問を送信
2. あなたが携帯電話から返信する
3. Claudeはすぐに作業を続ける
4. ダウンタイムゼロ！ ⚡

📖 関連ドキュメント:

• - 完全なセットアップガイド
• - AIアシスタントの使用例

その他のMCPクライアント

mcporter CLIを使用して簡単にテストできます。

mcporter call 'waha-mcp.waha_list_sessions()'
mcporter call 'waha-mcp.waha_send_text(chatId: "1234567890@c.us", text: "Hello from MCP!")'

🧰 ツールリファレンス

📂 カテゴリ

// Claude Codeが機能を構築中で、クラリファイケーションが必要
const reply = await ask_user_via_whatsapp({
  question: "APIにRESTとGraphQLのどちらを使用すべきですか？",
  chatId: "1234567890@c.us",
  timeoutMinutes: 30
});
// ユーザーが携帯電話から返信: "GraphQLを使用する"
// Claude CodeはGraphQLの実装を続けます

📚 Chat IDの形式

WhatsApp IDの形式を理解しましょう。

注意: 電話番号には + プレフィックスを含めないでください。

💻 使用例

テキストメッセージを送信

mcporter call 'waha-mcp.waha_send_text(
  chatId: "1234567890@c.us",
  text: "Hello from WAHA MCP!"
)'

URLから画像を送信

mcporter call 'waha-mcp.waha_send_image(
  chatId: "1234567890@c.us",
  imageUrl: "https://example.com/photo.jpg",
  caption: "Check this out!"
)'

グループを作成し、参加者を追加

# グループを作成
mcporter call 'waha-mcp.waha_create_group(
  name: "Team Chat",
  participants: ["1111111111@c.us", "2222222222@c.us"]
)'

# さらに参加者を追加
mcporter call 'waha-mcp.waha_add_group_participants(
  chatId: "{group_id}@g.us",
  participants: ["3333333333@c.us"]
)'

すべてのチャットをリスト表示

mcporter call 'waha-mcp.waha_list_chats()'

🧪 開発

ウォッチモードで実行

npm run dev  # ファイル変更時に再コンパイル

テストを実行

npm test

本番用にビルド

npm run build

📚 ドキュメント

詳細なドキュメントは、docs フォルダを参照してください。

• セッション管理
• メッセージングガイド
• グループ管理
• メディア処理
• トラブルシューティング

🤝 コントリビューション

コントリビューションは大歓迎です！ 問題やプルリクエストを自由に送信してください。

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを開く

📄 ライセンス

このプロジェクトは MITライセンス の下でライセンスされています - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• WAHA (WhatsApp HTTP API) - この統合の基盤
• Model Context Protocol - AIネイティブツールの統合を可能にする
• Anthropic - Claude DesktopとMCP SDKの提供