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 등을 통해 호출별로 전달할 수도 있습니다. Env는 기본값으로만 사용됩니다.

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

웹훅(도구 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/client.ts의 graphRequest()를 사용하여 src/tools/<produto>.ts에 도구 생성

3. src/index.ts에 등록(registerXxxTools를 통해 자동으로 처리됨)

라이선스

MIT.