Whatsapp (GreenAPI)

🚀 WhatsApp MCP サーバー

モデルコンテキストプロトコル (MCP) インターフェースを提供するサーバーで、FastMCP を通じて WhatsApp Business API とのインタラクションを可能にします。

🚀 クイックスタート

WhatsApp MCP サーバーは Python で実装されており、Claude などの言語モデルが GreenAPI を介して WhatsApp の機能とやり取りできるようにします。FastMCP を利用することで、パフォーマンスが向上し、開発者体験が改善され、よりクリーンなコード構造を実現します。

✨ 主な機能

• メッセージ送信：WhatsApp の連絡先にテキストメッセージを送信します。
• グループ管理：グループを作成し、メンバーを一覧表示し、参加者を追加/削除します。
• セッション管理：WhatsApp API セッションを管理します。
• チャット履歴：チャットリストとメッセージ履歴を取得します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/whatsapp-mcp-server.git
cd whatsapp-mcp-server

# 依存関係をインストールする
pip install -e .

# 環境変数を設定する
cp .env-template .env
# .env ファイルを編集して、あなたの GreenAPI 資格情報を入力してください

💻 使用例

基本的な使用法

# デフォルトのホスト (127.0.0.1) とポート (8000) で MCP サーバーを起動する
whatsapp-mcp

# ホストとポートを指定する
whatsapp-mcp --host 0.0.0.0 --port 9000

高度な使用法

# MCP モニターを使用してデバッグする
npx @modelcontextprotocol/inspector whatsapp-mcp

📚 ドキュメント

WhatsApp API クライアント

このプロジェクトでは、whatsapp-api-client-python ライブラリを使用して WhatsApp とやり取りします。このクライアントは、WhatsApp クラウド API へのアクセスを提供し、GreenAPI アカウントが必要です。

環境変数

このプロジェクトでは、環境変数を使用して構成します。

これらの変数は、環境に設定するか、提供されている .env ファイルを使用して設定できます（インストール手順を参照）。

開発

# 開発用の依存関係をインストールする
pip install -e ".[dev]"

# テストを実行する
pytest

# コードスタイルをチェックする
flake8 src/

# 型をチェックする
mypy src/

このプロジェクトは、現代的な pyproject.toml 構成を使用しており、以下を含みます。

• アプリケーションを実行するために必要な依存関係
• pip install -e ".[dev]" でインストールされる開発用の依存関係

📄 ライセンス

このプロジェクトは MIT License に基づいて配布されています。詳細については、LICENSE ファイルを参照してください。