🍉 mcp西瓜
MCP服务器 西瓜 --人工智能驱动的客户支持平台。公开所有13个公共API端点作为MCP工具，使人工智能助手能够管理联系人、对话、消息、自定义字段和网络挂钩。
🍉🍉🍉 免责声明 🍉🍉🍉 这是一个非官方的社区建设项目。 它是 不 认可、支持或附属于 西瓜 — *然而*。我们构建这个是因为我们喜欢他们正在构建的东西，并相信MCP集成使他们的平台更加强大。如果你来自西瓜，正在读这篇文章：让我们谈谈！ 🍉 *此README中的一些链接是联盟链接。如果您通过这些链接注册，我们将为您赚取小额佣金，而无需您支付额外费用。* 🍉
🍉 安装
需要Python 3.12+和 紫外线.
git clone https://github.com/cdit-dev/mcp-watermelon.git
cd mcp-watermelon
uv sync🍉 配置
将您的西瓜API证书设置为环境变量：
export WATERMELON_API_KEY="your-api-key"
export WATERMELON_SECRET_KEY="your-secret-key"没有西瓜账户？ 在这里注册。然后从“设置”下的仪表板获取API凭据→ API.
克劳德桌面/克劳德代码
添加到MCP配置中：
{
"mcpServers": {
"watermelon": {
"command": "uv",
"args": ["--directory", "/path/to/mcp-watermelon", "run", "server"],
"env": {
"WATERMELON_API_KEY": "your-api-key",
"WATERMELON_SECRET_KEY": "your-secret-key"
}
}
}
}Docker/容器部署
docker compose up -d在中设置凭据 .env （参见 .env.example).默认情况下，容器在端口8002的可流式http传输上运行。
🍉 可用工具
🍉 联系人（5个工具）
| 工具 | 说明 |
|---|---|
watermelon_contacts_create | 使用自定义字段创建新联系人 |
watermelon_contacts_get | 通过ID获取特定联系人 |
watermelon_contacts_list | 列出所有联系人 |
watermelon_contacts_update | 更新联系人的字段 |
watermelon_contacts_search | 按查询搜索联系人 |
🍉 对话（2个工具）
| 工具 | 说明 |
|---|---|
watermelon_conversations_list | 列出所有对话 |
watermelon_conversations_get | 通过消息进行对话 |
🍉 消息（2个工具）
| 工具 | 说明 |
|---|---|
watermelon_messages_send | 发送消息 |
watermelon_messages_get | 获取特定消息 |
🍉 自定义字段（1个工具）
| 工具 | 说明 |
|---|---|
watermelon_fields_list | 列出所有自定义字段定义 |
🍉 Webhooks（3个工具）
| 工具 | 说明 |
|---|---|
watermelon_webhooks_create | 创建webhook |
watermelon_webhooks_update | 更新webhook |
watermelon_webhooks_delete | 删除webhook |
🍉 用例
适合任何西瓜用户
🍉 对话式客户支持监控
“显示所有打开的对话”→ “总结对话X中的最后5条消息”→ “发送后续消息”
🍉 通过自然语言进行联系人管理
“为Jane Doe创建联系人，电子邮件jane@example.com，公司Acme Corp”→“在Acme搜索联系人”→“更新Jane的电话号码”
🍉 Webhook自动化设置
“设置一个webhook，以便在有新对话时通知我”→ “更新webhook URL以指向我的新端点”
面向代理商和平台建设者
🍉 联系人与CRM同步 使用n8n或Zapier保持西瓜和CRM之间的联系人同步。当西瓜中出现新联系人时（通过webhook），在CRM中创建/更新它。当CRM联系人标记为“支持活动”时，使用自定义字段将其推送到西瓜。
🍉 AI优先支持收件箱 西瓜的人工智能聊天机器人处理一线对话。MCP服务器允许Claude监控对话质量、标记升级并发送人工辅助响应——所有这些都可以从您用于其他所有操作的同一界面进行。
🍉 客户对话智能 收集所有对话，与克劳德分析情绪和话题，生成每周支持摘要。将您的支持收件箱转化为可操作的商业智能。
🍉 多客户端webhook编排 对于每个客户端工作区，设置输入到自动化平台的Watermelon webhooks。新对话→ 通知延迟。对话已解决→ 更新CRM交易。消息已收到→ 记录到客户端时间线。
🍉 支持驱动的内容创意 拉客户对话，使用Claude识别重复出现的问题和痛点，然后将其转化为常见问题文章、博客文章或视频内容。
🍉 使用未来的API扩展
如果西瓜扩大了公共API，这些用例就成为可能（参见 GAP_ANALYSIS.md):
| 用例 | 必需的API扩展 |
|---|---|
| 自动关闭已解析的对话 | 对话生命周期端点 |
| 人工智能辅助知识库管理 | 知识库CRUD |
| 支持质量仪表板 | 分析读取权限 |
| 动态聊天机器人提示调优 | 聊天机器人配置端点 |
| 按主题自动分配对话 | 对话分配端点 |
🍉 API覆盖范围
此服务器涵盖 西瓜100%公开API （13个端点）。看 GAP_ANALYSIS.md 以详细分析哪些平台功能可以通过API访问，哪些不能通过API访问。
🍉 关于西瓜
西瓜 是一个基于人工智能的客户支持平台，帮助企业实现跨渠道对话的自动化。如果你还没有用西瓜， 在这里试试 --他们第一年提供25%的折扣 合作伙伴/联盟计划 我也是。
🍉 许可证
麻省理工学院
______________________________________________________________________
*建于🍉 通过 CDIT*