YCloud WhatsApp API MCP 服务器
2025.04.14
0
TypeScriptWhatsApp API集成AI模型交互交流协作
YCloud WhatsApp API MCP 服务器是一个基于Model Context Protocol (MCP)构建的服务器，能够自动从YCloud WhatsApp OpenAPI规范中生成工具，使AI模型（如Claude）可以直接与YCloud WhatsApp API交互。它支持所有YCloud API端点，包括API认证、参数类型和验证处理，以及HTTP请求和响应处理。
View on GitHub
Overview
基本能力
产品定位
YCloud WhatsApp API MCP 服务器旨在为开发者提供一个桥梁，使AI模型能够通过MCP协议与YCloud WhatsApp API进行交互，实现自动化消息处理和账户管理等功能。
核心功能
- 自动从OpenAPI规范生成MCP工具
- 支持所有YCloud API端点
- 支持API认证
- 自动处理参数类型和验证
- 支持HTTP请求和响应处理
适用场景
- AI模型（如Claude）与WhatsApp API的集成
- 自动化消息发送和接收
- 账户信息查询和管理
工具列表
- MCP Inspector：用于检查服务器的运行状态
常见问题解答
- 如何获取API密钥？：登录YCloud控制台，导航到开发者页面获取API密钥。
- 如何调试服务器？：可以通过查看服务器日志、使用MCP Inspector工具或在Claude桌面应用中查看服务器状态和日志来调试。
使用教程
使用依赖
- Node.js v16.0.0 或更高版本
- npm v7.0.0 或更高版本
- Claude 桌面应用（如果要与 Claude 集成）
安装教程
# 克隆仓库
git clone https://github.com/YCloud-Developers/ycloud-whatsapp-mcp-server.git
cd ycloud-whatsapp-mcp-server
# 安装依赖
npm install
# 构建项目
npm run build
调试方式
- 查看服务器日志：服务器运行时会输出调试信息
- 使用MCP Inspector：检查服务器的运行状态
- Claude桌面端调试：在Claude桌面应用中可以查看服务器状态和日志
# 设置环境变量并运行
API_BASE_URL=https://api.ycloud.com/v2 \
API_HEADERS="X-API-Key:your-api-key-here" \
npm start