Zender MCP

Zender MCP 服务器

一个用于ConvoChat/Zender的MCP（模型上下文协议）服务器，允许从Claude发送SMS和WhatsApp消息。

🚀 特点

• 短信通过安卓设备或信用额度发送短信
• WhatsApp发送文本、多媒体和文档信息
• 账户管理WhatsApp账号的绑定与管理
• 信息设备、积分和订阅查询
• Docker配置就绪，准备生产

📋 要求

• Node.js 18及以上版本
• ConvoChat/Zender 的 API 密钥，权限为：

- sms_send - wa_send - get_rates - get_wa_accounts - create_whatsapp - validate_wa_phone - get_devices - get_credits - get_subscription

🛠️ 安装

选项1：Docker Hub（推荐）🐳

# Descargar y ejecutar directamente desde Docker Hub
docker run -it --rm \
  -e ZENDER_API_KEY=tu_api_key \
  renatoascencio/zender-mcp:latest

选项2：地方发展

1. 克隆并安装依赖项：

git clone https://github.com/RenatoAscencio/zender-mcp.git
cd zender-mcp
npm install

1. 设置环境变量：

cp .env.example .env
# Editar .env con tu API key

1. 构建并执行：

npm run build
npm start

选项3：本地Docker

1. 塑造形象：

docker build -t zender-mcp .

1. 使用 docker-compose 运行：

# Configurar variables en docker-compose.yml
docker-compose up -d

🔧 与Claude的配置

方法1：Claude桌面应用程序

1. 定位配置文件：

- macOS（发音为“Mac OS”，其中“OS”代表“Operating System”，即操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json

1. 添加MCP配置：

{
  "mcpServers": {
    "zender": {
      "command": "node",
      "args": ["/ruta/completa/a/zender-mcp/dist/index.js"],
      "env": {
        "ZENDER_API_KEY": "tu_api_key_de_convo_chat"
      }
    }
  }
}

1. 重启Claude桌面版 以加载配置。

方法2：Claude Code（命令行界面）

1. 创建本地配置：

# En el directorio del proyecto
echo '{"mcpServers":{"zender":{"command":"node","args":["./dist/index.js"]}}}' > .claude-config.json

1. 使用Claude代码运行：

claude-code --mcp-config .claude-config.json

方法3：使用Docker Hub与Claude（更简单）⭐ 推荐

具有自动配置功能（无需运行 zender_configure)：

{
  "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 - 发送短信

WhatsApp

• 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. 配置服务器

{
  "tool": "zender_configure",
  "arguments": {
    "apiKey": "tu_api_key_aqui",
    "baseUrl": "https://sms.convo.chat/api"
  }
}

2. 发送短信

{
  "tool": "zender_send_sms",
  "arguments": {
    "phone": "+573001234567",
    "message": "Hola desde Claude!",
    "mode": "devices",
    "device": "mi_dispositivo_id",
    "priority": 1
  }
}

3. 发送WhatsApp消息

{
  "tool": "zender_send_whatsapp",
  "arguments": {
    "account": "mi_cuenta_wa",
    "recipient": "+573001234567",
    "message": "Mensaje desde Claude via WhatsApp",
    "type": "text",
    "priority": 1
  }
}

4. 绑定WhatsApp

{
  "tool": "zender_link_whatsapp",
  "arguments": {
    "sid": 123
  }
}

✅ 检查配置

1. 在本地测试MCP服务器：

# 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 无法运行

• 原因未构建的镜像或缺少环境变量
• 解决方案：

  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用户运行

🐛 开发

可用脚本

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）

🤝 贡献

1. 为仓库创建分支
2. 创建功能分支（git checkout -b feature/nueva-funcionalidad）
3. 提交更改（git commit -am 'Agregar nueva funcionalidad'）
4. 推送至分支（git push origin feature/nueva-funcionalidad）
5. 创建拉取请求

📞 支持

如需报告错误或请求功能，请在GitHub上创建一个issue。

______________________________________________________________________

为Claude/MCP社区用心打造 ❤️