Zender MCP 服务器
一个用于ConvoChat/Zender的MCP(模型上下文协议)服务器,允许从Claude发送SMS和WhatsApp消息。
🚀 特点
- 短信通过安卓设备或信用额度发送短信
- WhatsApp发送文本、多媒体和文档信息
- 账户管理WhatsApp账号的绑定与管理
- 信息设备、积分和订阅查询
- Docker配置就绪,准备生产
📋 要求
- Node.js 18及以上版本
- ConvoChat/Zender 的 API 密钥,权限为:
sms_sendwa_sendget_ratesget_wa_accountscreate_whatsappvalidate_wa_phoneget_devicesget_creditsget_subscription
🛠️ 安装
选项1:Docker Hub(推荐)🐳```bash
Descargar y ejecutar directamente desde Docker Hub
docker run -it --rm \
-e ZENDER_API_KEY=tu_api_key \
renatoascencio/zender-mcp:latest
### 选项2:地方发展
1. **克隆并安装依赖项:**```bash
git clone https://github.com/RenatoAscencio/zender-mcp.git
cd zender-mcp
npm install
- 设置环境变量:```bash
cp .env.example .env
Editar .env con tu API key
3. **构建并执行:**```bash
npm run build
npm start
选项3:本地Docker
- 塑造形象:```bash
docker build -t zender-mcp .
2. **使用 docker-compose 运行:**```bash
# Configurar variables en docker-compose.yml
docker-compose up -d
🔧 与Claude的配置
方法1:Claude桌面应用程序
- 定位配置文件:
- macOS(发音为“Mac OS”,其中“OS”代表“Operating System”,即操作系统):
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- 添加MCP配置:```json
{
"mcpServers": {
"zender": {
"command": "node",
"args": ["/ruta/completa/a/zender-mcp/dist/index.js"],
"env": {
"ZENDER_API_KEY": "tu_api_key_de_convo_chat"
}
}
}
}
3. **重启Claude桌面版** 以加载配置。
### 方法2:Claude Code(命令行界面)
1. **创建本地配置:**```bash
# En el directorio del proyecto
echo '{"mcpServers":{"zender":{"command":"node","args":["./dist/index.js"]}}}' > .claude-config.json
- 使用Claude代码运行:```bash
claude-code --mcp-config .claude-config.json
### 方法3:使用Docker Hub与Claude(更简单)⭐ 推荐
**具有自动配置功能(无需运行 `zender_configure`):**```json
{
"mcpServers": {
"zender": {
"command": "docker",
"args": [
"run", "-i", "--rm", "--init",
"-e", "ZENDER_API_KEY=tu_api_key_aqui",
"renatoascencio/zender-mcp:latest"
]
}
}
}
> 注: 当你配置时 ZENDER_API_KEY 作为环境变量,服务器会自动进行自我配置,并且 你不需要 执行 zender_configure 在Claude中。你可以直接使用工具,如 zender_get_devices, zender_get_whatsapp_accounts等。
⚠️ 重要提示:
- 替换
/ruta/completa/a/zender-mcp使用你项目的真实路径 - 在https://sms.convo.chat/dashboard/tools/keys获取你的API密钥
- 确保服务器已编译:
npm run build
📚 可用工具
配置
zender_configure- 配置API连接
短信(SMS)
zender_send_sms- 发送短信
zender_send_whatsapp- 发送WhatsApp消息zender_get_whatsapp_servers- 获取可用服务器zender_link_whatsapp- 绑定WhatsApp账号zender_relink_whatsapp- 重新绑定现有账户zender_validate_whatsapp_number- 验证WhatsApp号码zender_get_whatsapp_accounts- 获取关联账户
信息
zender_get_devices- 获取Android设备zender_get_credits- 查询信用额度zender_get_subscription- 订阅信息zender_get_gateway_rates- 短信网关费用
💡 使用示例
1. 配置服务器```json
{
"tool": "zender_configure",
"arguments": {
"apiKey": "tu_api_key_aqui",
"baseUrl": "https://sms.convo.chat/api"
}
}
### 2. 发送短信```json
{
"tool": "zender_send_sms",
"arguments": {
"phone": "+573001234567",
"message": "Hola desde Claude!",
"mode": "devices",
"device": "mi_dispositivo_id",
"priority": 1
}
}
3. 发送WhatsApp消息```json
{
"tool": "zender_send_whatsapp",
"arguments": {
"account": "mi_cuenta_wa",
"recipient": "+573001234567",
"message": "Mensaje desde Claude via WhatsApp",
"type": "text",
"priority": 1
}
}
### 4. 绑定WhatsApp```json
{
"tool": "zender_link_whatsapp",
"arguments": {
"sid": 123
}
}
✅ 检查配置
1. 在本地测试MCP服务器:```bash
Compilar el proyecto
npm run build
Probar que responde correctamente
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | node dist/index.js
### 2. 在Claude上验证:
设置完成后,在Claude中你应该能看到可用的工具:
- `zender_configure`
- `zender_send_sms`
- `zender_send_whatsapp`
- 以及另外9种工具。..
### 3. 在Claude上的首次使用:```
Configura Zender con mi API key: [tu_api_key]
🛠️ 问题解决
“Zender 客户端未配置”
- 原因你尚未执行
zender_configure首先 - 解决方案使用你的API密钥执行初始设置
“模块未找到”或“命令未找到”
- 原因MCP设置中的路径错误
- 解决方案检查文件的完整路径
dist/index.js
API密钥无效
- 原因API密钥不正确或无权限
- 解决方案在https://sms.convo.chat/dashboard/tools/keys上验证你的API密钥
Docker 无法运行
- 原因未构建的镜像或缺少环境变量
- 解决方案:```bash
docker build -t zender-mcp .
docker run -e ZENDER_API_KEY=tu_key -i --rm zender-mcp
### 克劳德无法识别服务器
- **原因**MCP配置错误或未重启Claude
- **解决方案**:
1. 验证配置的JSON语法
1. 完全重启 Claude Desktop
1. 检查Claude的日志
## 🔒 安全
- API密钥通过环境变量进行安全处理
- 使用Zod模式进行输入验证
- HTTP请求设置的超时时间
- 在Docker中以非root用户运行
## 🐛 开发
### 可用脚本```bash
npm run dev # Desarrollo con recarga automática
npm run build # Construir para producción
npm run start # Ejecutar versión construida
npm test # Ejecutar tests
项目结构```
src/
├── index.ts # Servidor MCP principal
├── zender-client.ts # Cliente para API ConvoChat
└── types.ts # Tipos y schemas de validación
```
📄 许可证
麻省理工学院(MIT)
🤝 贡献
- 为仓库创建分支
- 创建功能分支(
git checkout -b feature/nueva-funcionalidad) - 提交更改(
git commit -am 'Agregar nueva funcionalidad') - 推送至分支(
git push origin feature/nueva-funcionalidad) - 创建拉取请求
📞 支持
如需报告错误或请求功能,请在GitHub上创建一个issue。
为Claude/MCP社区用心打造 ❤️
