内容
# @joltsms/mcp-server
用于 [JoltSMS](https://joltsms.com) 的MCP服务器 — 提供专用的真实SIM美国电话号码，并通过AI代理接收短信/OTP验证码。
该服务器基于 [模型上下文协议](https://modelcontextprotocol.io) 构建，为AI代理（如Claude Code、Claude Desktop、Cursor等）提供租用电话号码、等待传入短信、提取OTP验证码和管理计费的功能 — 所有这些都通过标准化的工具调用实现。
## 快速开始
### 1. 获取API密钥
在 **[仪表盘 → 设置 → API密钥](https://app.joltsms.com/settings)** 处创建JoltSMS账户并生成API密钥。
### 2. 配置MCP客户端
在您的 `.mcp.json`（Claude Code）或MCP设置（Claude Desktop，Cursor）中添加：
```json
{
"mcpServers": {
"joltsms": {
"command": "npx",
"args": ["-y", "@joltsms/mcp-server"],
"env": {
"JOLTSMS_API_KEY": "jolt_sk_您的密钥_在此"
}
}
}
}
```
### 3. 使用它
您的AI代理现在可以访问所有JoltSMS工具。试试：
> "分配一个带有区号650的新电话号码，并等待OTP"
## 工具
| 工具 | 描述 |
|------|-------------|
| `joltsms_list_numbers` | 列出带有服务标签、标签和未读计数的主动号码 |
| `joltsms_get_number` | 获取单个号码的完整详细信息 |
| `joltsms_update_number` | 在号码上设置服务标签、标签或备注 |
| `joltsms_provision_number` | 租用新的专用真实SIM美国号码（$50/月） |
| `joltsms_release_number` | 在计费周期结束时取消/释放号码 |
| `joltsms_list_messages` | 列出带有解析的OTP代码的最近短信 |
| `joltsms_mark_read` | 将单个或批量消息标记为已读 |
| `joltsms_wait_for_sms` | 轮询直到收到短信（OTP流程的关键工具） |
| `joltsms_get_latest_otp` | 获取最近的解析验证代码 |
| `joltsms_billing_status` | 检查所有具有计费健康状况的订阅 |
## OTP验证工作流程
最常见的用例 — 自动电话验证：
```
1. joltsms_provision_number({ area_code: "650" })
→ 号码 provisioning 开始！电话：+16505551234
2. joltsms_update_number({ number_id: "+16505551234", service_name: "PayPal" })
→ 添加标签以便后续查找
3. [代理在PayPal上输入电话号码并请求OTP]
4. joltsms_wait_for_sms({ number_id: "+16505551234", timeout_seconds: 120 })
→ 8.2秒后收到短信： "您的PayPal代码是847291"
→ OTP 代码：847291
5. joltsms_mark_read({ number_id: "+16505551234" })
→ 收件箱清理
6. [代理在PayPal上输入847291 — 验证完成]
```
## 环境变量
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `JOLTSMS_API_KEY` | 是 | 您的API密钥（`jolt_sk_*`） |
| `JOLTSMS_API_URL` | 否 | API基础URL（默认为 `https://api.joltsms.com`） |
## 要求
- Node.js 18+
- 具有已记录付款方式的JoltSMS账户
- 您的第一个号码必须通过 [仪表盘](https://app.joltsms.com) 订购，以完成初始3D安全验证
## 文档
- [MCP服务器文档](https://joltsms.com/developers/mcp)
- [API参考](https://joltsms.com/developers/api-reference)
- [JoltSMS网站](https://joltsms.com)
## 许可证
MIT
