mcp-meta

Meta Business Messaging向けのMCPサーバー：WhatsApp Cloud API、Messenger Platform、Instagram Messaging、Graph API Webhooks。

約55のツールを4つの製品にまとめてカバーしています。すべてのエンドポイントは graph.facebook.com/{version} を指します（デフォルトは v22.0、META_API_VERSION で上書き可能）。

インストール

cd /Users/barboza/Solutions/mcp-meta
npm install
npm run build

設定（環境変数）

すべてオプションです — ツール呼び出しの引数で access_token / phone_number_id / などを渡すこともできます。環境変数は単なるデフォルトとして機能します。

Claude Code / MCPクライアントでの使用

~/.claude.json（または同等のもの）に追加してください：

{
  "mcpServers": {
    "meta": {
      "command": "node",
      "args": ["/Users/barboza/Solutions/mcp-meta/dist/index.js"],
      "env": {
        "WHATSAPP_ACCESS_TOKEN": "EAAJB...",
        "WHATSAPP_PHONE_NUMBER_ID": "1234567890",
        "WHATSAPP_BUSINESS_ACCOUNT_ID": "987654321",
        "MESSENGER_PAGE_ACCESS_TOKEN": "EAAJB...",
        "MESSENGER_PAGE_ID": "1111111",
        "META_APP_SECRET": "...",
        "META_VERIFY_TOKEN": "..."
      }
    }
  }
}

開発用（tsx、ビルドなし）：

"args": ["--import", "tsx", "/Users/barboza/Solutions/mcp-meta/src/index.ts"]

利用可能なツール

ディスカバリー

• meta_list_tools(product?) — マッピングされたすべてのツールとエンドポイントを一覧表示します

• リソース meta://reference/endpoints.json — JSON形式の完全なカタログ

WhatsApp Cloud API（約26ツール）

メッセージ：whatsapp_send_text, whatsapp_send_image, whatsapp_send_audio, whatsapp_send_video, whatsapp_send_document, whatsapp_send_sticker, whatsapp_send_location, whatsapp_send_contacts, whatsapp_send_reaction, whatsapp_send_template, whatsapp_send_reply_buttons, whatsapp_send_list, whatsapp_send_cta_url, whatsapp_send_flow

状態：whatsapp_mark_as_read

メディア：whatsapp_upload_media, whatsapp_get_media, whatsapp_delete_media

テンプレート：whatsapp_list_templates, whatsapp_create_template, whatsapp_delete_template

プロフィール/アカウント：whatsapp_get_business_profile, whatsapp_update_business_profile, whatsapp_list_phone_numbers, whatsapp_register_phone_number, whatsapp_block_users

Messenger Platform（約14ツール）

messenger_send_text, messenger_send_quick_replies, messenger_send_attachment, messenger_send_generic_template, messenger_send_button_template, messenger_send_media_template, messenger_sender_action, messenger_upload_attachment, messenger_get_user_profile, messenger_list_conversations, messenger_set_profile, messenger_get_profile, messenger_pass_thread_control, messenger_take_thread_control

Instagram Messaging（約10ツール）

instagram_send_text, instagram_send_quick_replies, instagram_send_attachment, instagram_send_generic_template, instagram_send_button_template, instagram_send_product_template, instagram_private_reply_to_comment, instagram_react_to_message, instagram_get_user_profile, instagram_list_conversations

Webhooks（3ツール）

webhook_verify_challenge, webhook_validate_signature, webhook_parse_event

ソース・オブ・トゥルース

ファイル reference/endpoints.json はエンドポイントの正規カタログです — developers.facebook.com/documentation/business-messaging/... と developers.facebook.com/docs/messenger-platform/... の公式ドキュメントをクロールして生成されました。

各ツールはこのカタログのエンドポイントをラップします。新しいエンドポイントのサポートを追加するには：

1. reference/endpoints.json にエントリを追加する

2. src/tools/<produto>.ts に src/client.ts の graphRequest() を使ってツールを作成する

3. src/index.ts に登録する（registerXxxTools で自動化済み）

ライセンス

MIT。