WhatsApp Message Sender MCP Tool

WhatsApp Message Sender MCP Tool

Meta（Facebook）の WhatsApp Business API を使用して WhatsApp メッセージを送信する MCP（Model Context Protocol）です。

要件

• Python 3.12 以上
• uv（Python パッケージマネージャー）
• Meta WhatsApp Business API の認証情報

インストール

1. リポジトリをクローンします：

git clone https://github.com/deuslirio/mcp-server-whatsapp-message.git
cd mcp-server-whatsapp-message

2. uv を使用して依存関係をインストールします：

uv pip install -e .

サーバーの起動

スタンドアロンモード

次のコマンドでサーバーを起動します：

uv run python main.py

サーバーが起動し、リクエストを受け付ける準備が整います。

Claude Local との連携

このツールを Claude Local の設定に追加するには、Claude の設定に次の内容を追加します：

{
    "mcpServers": {
        "whatsapp": {
            "command": "uv",
            "args": [
                "run",
                "\\\\wsl.localhost\\Ubuntu-24.04\\home\\deuslirio\\PycharmProjects\\mcp-server-whatsapp-message\\main.py"
            ],
            "env": {
                "META_ACCESS_TOKEN": "your-token-here",
                "META_PHONE_NUMBER_ID": "your-phone-id-here"
            }
        }
    }
}

注：環境変数の値を、実際の Meta API 認証情報に置き換えてください。

利用可能なツール

send_whatsapp_message

指定した電話番号に WhatsApp メッセージを送信します。

パラメーター：

• phone_number：受信者の電話番号（文字列、国際形式。例：+5562995631588）
• message：送信するメッセージ（文字列）

使用例：

{
    "phone_number": "+5562000000000",
    "message": "Hello! This is a test message!"
}

利用可能なリソース

contacts

名前と電話番号を含む連絡先の一覧を返します。

URI：resource://contacts

応答例：

[
    {"name": "João da Silva", "phone_number": "+55629999999999"}
]

デモ

WhatsApp Message Sender MCP Tool の動作を示すスクリーンショットを以下に示します：

メッセージの送信

メッセージの受信

contacts リソースの使用

受信したメッセージ

トラブルシューティング

よくある問題

1. FastMCP のインポートエラー：

   • mcp パッケージが正しくインストールされていることを確認します：

     uv pip install mcp==1.6.0
     

2. 環境変数エラー：

   • 環境変数が Claude Local の設定で正しく設定されていることを確認します
   • 変数の値が正しいことを確認します

3. uv run の実行時エラー：

   • uv のキャッシュをクリアしてみてください：

     uv cache clean
     

   • 依存関係を再インストールします：

     uv pip install -e .
     

プロジェクト構成

mcp-server-whatsapp-message/
├── main.py                  # Server entry point
├── mcp_server/              # Main module
│   ├── __init__.py          # Module initialization
│   └── whatsapp_handler.py  # WhatsApp message handler
├── pyproject.toml           # Project configuration
├── requirements.txt         # Project dependencies
└── .env                     # Environment variables (not versioned)

コントリビューション

コントリビューションを歓迎します！お気軽に Issue を作成するか、プルリクエストを送信してください。