Whatsapp

🚀 WhatsApp MCP プロトコルサーバ

このプロジェクトは、WhatsApp とのやり取りを行うための MCP（モデルコンテキストプロトコル）サーバです。このシステムには 2 つの主要なコンポーネントが含まれています。

1. Go 言語のブリッジ：WhatsApp API との接続を担当し、SQLite データベースを維持し、すべてのメッセージ履歴を保存します。
2. Python MCP サーバ：MCP プロトコルを実装し、Claude が使用するための標準化されたツールを提供します。

🚀 クイックスタート

📦 インストール

コードのダウンロード

Git を使用してプロジェクトリポジトリをクローンします。

git clone https://github.com/your-username/whatsapp-mcp.git

WhatsApp-MCP ディレクトリに移動します。

cd whatsapp-mcp

Go ブリッジの実行

ブリッジを起動する前に、Go 言語環境がインストールされていることを確認してください。その後、ターミナルで以下のコマンドを実行します。

go run bridge/main.go

Python MCP サーバの起動

このサーバは Flask フレームワークを使用して実装されています。まず、依存関係をインストールします。

pip install flask requests

次に、サーバを実行します。

python server/mcp_server.py

✨ 主な機能

データストレージ

• データベースの位置：whatsapp-bridge/store/
• チャット記録：すべてのメッセージが時系列で保存され、高速な検索と取得がサポートされています。
• インデックス最適化：SQLite のクエリ最適化技術を通じて、データアクセスの効率を向上させます。

MCP ツール

Claude は以下のツールを通じて WhatsApp とやり取りすることができます。

検索機能

• search_contacts：名前または番号で連絡先を検索します。
• list_messages：メッセージを検索し、フィルタリングとコンテキスト拡張をサポートします。
• list_chats：すべての利用可能なチャット記録をリストし、メタデータを含みます。

連絡先操作

• get_chat：特定のチャットの詳細情報を取得します。
• get_direct_chat_by_contact：指定された連絡先との直接のチャットを検索します。
• get_contact_chats：特定の連絡先が参加しているすべてのチャットを列挙します。

メッセージ処理

• get_last_interaction：特定の連絡先との最新のメッセージを取得します。
• get_message_context：特定のメッセージのコンテキスト情報を取得します。

送信機能

• send_message：指定された番号またはグループにテキストメッセージを送信します。
• send_file：画像、動画、ドキュメントなどのファイルを送信します。
• send_audio_message：音声メッセージを送信します。.ogg 形式であることを確認するか、FFmpeg をインストールして形式変換を行ってください。

メディア管理

• download_media：指定されたメッセージ内のメディアファイルをダウンロードし、ローカルパスを返します。

📚 ドキュメント

メディア処理

送信ルール

• サポートされるタイプ：画像、動画、ドキュメントなどは send_file を通じて送信できます。
• 音声送信：send_audio_message ツールを使用します。.ogg 形式であることを確認するか、FFmpeg で変換してください。

ダウンロード機能

デフォルトではメディアのメタデータのみが保存されます。実際のファイルを取得するには、download_media ツールを使用し、message_id と chat_jid を入力すると、ダウンロードしてパスを返します。

技術詳細

1. リクエストフロー：Claude -> Python サーバ -> Go ブリッジ -> WhatsApp API
2. データストレージ：すべてのメッセージが SQLite データベースに保存され、効率的なクエリが可能です。
3. デバイス制限：WhatsApp のデバイスリンク数には制限があります。定期的に使用しないデバイスをクリーンアップしてください。

トラブルシューティング

• 権限問題：スクリプトに十分なファイルアクセス権限があることを確認してください。PATH 環境変数が設定されていない場合は、フルパスでコマンドを実行することをお勧めします。
• 認証失敗：WhatsApp のデバイス制限に達していないか確認してください。携帯電話の設定 -> リンクされたデバイス管理で古いデバイスをクリーンアップできます。

付録

サンプルコード

Go ブリッジの起動

package main

import (
    "fmt"
    "log"
)

func main() {
    fmt.Println("WhatsApp Bridge Started")
    // データベース初期化ロジック
}

Python サーバの実行

from flask import Flask
import requests

app = Flask(__name__)

@app.route('/api/send_message', methods=['POST'])
def send_message():
    # メッセージ送信ロジックを処理する
    return "Message Sent"

コマンドラインの例

ブリッジを起動します。

go run bridge/main.go

サーバを実行します。

python server/mcp_server.py

📄 ライセンス

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