SMS.ir MCP Server
Overview
基本能力
产品定位
mcp-sms-ir 是一个短信服务集成工具，旨在通过 MCP 协议为 AI 助手提供短信发送能力。
核心功能
- 发送单条短信：支持向单个手机号发送短信。
- 批量发送短信：支持向多个手机号发送相同的短信内容。
- 发送验证码短信：支持通过模板发送验证码短信。
- 检查账户余额：支持查询 SMS.ir 账户的剩余信用额度。
适用场景
- AI 助手集成短信通知功能。
- 批量发送营销或通知短信。
- 发送验证码短信用于用户验证。
- 定期检查短信服务账户余额。
工具列表
send_sms：向单个手机号发送短信。-
参数：
mobile（手机号）、message（短信内容）、lineNumber（可选，发送号码）、sendDateTime（可选，发送时间）。 -
send_bulk_sms：向多个手机号批量发送短信。 -
参数：
mobiles（手机号数组）、messageText（短信内容）、lineNumber（可选）、sendDateTime（可选）。 -
send_verification_code：通过模板发送验证码短信。 -
参数：
mobile（手机号）、templateId（模板 ID）、parameters（模板参数）。 -
check_credit：检查账户余额。 - 参数：无。
常见问题解答
- 如何获取 API Key？：在 SMS.ir 官网注册并登录，从用户面板的 API Key 部分获取。
- 如何配置 MCP Server？：通过
npx或本地安装方式配置，需提供 API Key。 - 如何发布到 npm？：完成
npm login和npm publish步骤即可。
使用教程
使用依赖
-
Node.js v18 或更高版本：
bash # 检查 Node.js 版本 node --version -
SMS.ir API Key：从 SMS.ir 官网获取。
安装教程
方法 1：通过 npm 安装（推荐）
无需安装，直接通过 npx 运行：
npx -y mcp-sms-ir
方法 2：手动安装
-
克隆仓库：
bash git clone https://github.com/your-username/mcp-sms-ir.git cd mcp-sms-ir -
安装依赖：
bash bun install # 或 npm install -
构建项目：
bash npm run build -
（可选）本地发布：
bash npm link
调试方式
-
配置完成后，通过 Claude 或 Cline 发送测试短信：
json { "mobile": "09121234567", "message": "测试短信" } -
检查账户余额：
json { "tool": "check_credit" } -
查看日志或返回结果确认功能是否正常。