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/client.ts 中的 graphRequest() 在 src/tools/<produto>.ts 中创建工具

3. 在 src/index.ts 中注册（已通过 registerXxxTools 自动完成）

许可证

MIT。