AI导哈

消息协议服务器

Zender MCP Server是一个用于ConvoChat/Zender的模型上下文协议服务器，支持通过Claude发送SMS和WhatsApp消息。

  • by serversmx
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 RenatoAscencio/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

  2. 添加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语法
    2. 完全重启 Claude Desktop
    3. 检查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社区用心打造 ❤️

相关 MCP