WhatsApp消息协议服务

MCP (Model Context Protocol) 服务器,用于Peach WhatsApp消息平台,允许AI助手如Claude通过您的Peach账户发送消息、管理模板、联系人和媒体。

  • by trypeach-io
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 trypeach-io/mcp

使用说明

@peachai/mcp

MCP(模型上下文协议)服务器 桃子 WhatsApp消息平台。让像Claude这样的人工智能助手直接通过您的Peach帐户发送消息、管理模板、联系人和媒体。

需求

  • Node.js 18或更高版本
  • 带有API密钥的Peach帐户

获取API密钥

登录 好吧,我们试试吧。首选 设置→ API,并复制您的API密钥。

设置

托管服务器设置

推荐 Peach提供托管MCP服务器。我们建议使用这个。

{
  "mcpServers": {
    "peach": {
      "url": "https://app.trypeach.ai/api/mcp",
      "headers": {
        "Authorization": "<YOUR PEACH API KEY>"
      }
    }
  }
}

克劳德桌面版

将以下内容添加到您的 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "peach": {
      "command": "npx",
      "args": ["-y", "@peachai/mcp"],
      "env": {
        "PEACH_API_KEY": "your-api-key"
      }
    }
  }
}

重新启动克劳德桌面。您应该在对话中看到可用的Peach工具。

光标

首选 设置→ MCP 并添加:

{
  "peach": {
    "command": "npx",
    "args": ["-y", "@peachai/mcp"],
    "env": {
      "PEACH_API_KEY": "your-api-key"
    }
  }
}

克劳德代码

运行此命令将Peach AI添加到您的Claude Code设置中:

claude mcp add --scope user --env PEACH_API_KEY=your-api-key peach -- npx -y @peachai/mcp

或者手动将其添加到您的 .mcp.json:

{
  "mcpServers": {
    "peach": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@peachai/mcp"],
      "env": {
        "PEACH_API_KEY": "your-api-key"
      }
    }
  }
}

反重力

转到反重力设置->自定义。单击打开MCP配置并添加以下内容:

{
  "mcpServers": {
    "peach": {
      "serverUrl": "https://app.trypeach.ai/api/mcp",
       "headers": {
        "Authorization": "<YOUR PEACH API KEY>"
      }
    }
  }
}

可用工具

消息传递

工具 说明
peach_send_template_message 向联系人发送WhatsApp模板消息
peach_send_app_message 触发流或应用程序启动的消息
peach_connect_to_ai_agent 发送模板并将联系人连接到AI代理
peach_get_event_status 检查已发送事件的状态
peach_list_template_messages 使用筛选器列出已发送的模板消息

广播

工具 说明
peach_launch_broadcast 创建并启动广播活动

模板

工具 说明
peach_list_templates 列出所有WhatsApp模板
peach_get_template 按ID或名称获取特定模板
peach_create_template 创建新的WhatsApp模板
peach_update_template 更新现有模板
peach_submit_template 提交模板以供Meta审核
peach_pause_template 暂停已批准的模板
peach_archive_template 存档模板

联系人

工具 说明
peach_create_contact 创建或追加销售单个联系人
peach_create_contacts 批量创建或追加销售联系人
peach_update_contact 按电话号码更新联系人

媒体

工具 说明
peach_list_media 列出上传的媒体文件
peach_upload_media 上传媒体文件(base64)
peach_delete_media 删除媒体文件

消息

工具 说明
peach_list_messages 列出带有可选筛选器的邮件

示例提示

  • “将订单确认模板发送至+14155552671,订单ID为12345”
  • “创建一个名为summer_sale的新营销模板,其正文为‘本周末享受八折优惠!’”
  • “列出我批准的所有WhatsApp模板”
  • “将联系人+14155552671的姓名更新为约翰·史密斯”
  • “使用模板promo_v2向观众列表abc123发起广播”