Platfone - Receive SMS & Virtual Numbers MCP

Platfone MCP 服务器

Platfone 提供用于账户验证、测试和自动化工作流程的虚拟电话号码。Platfone MCP 服务器使 AI 代理能够从兼容 MCP 的客户端（如 Claude、VS Code Copilot、Codex 等）获取临时号码并接收短信。

📖 文档 · 🔧 设置指南 · 🔑 获取 API 密钥 · 📦 npm

为什么选择 MCP？

无需手动集成 API，AI 代理可以：

• 按国家和服务名称自主订购号码
• 等待短信验证码
• 重试或取消激活

全部通过结构化的工具调用完成 — 无需自定义后端。

功能特性

• 完整的激活生命周期 — 从订购号码到接收短信
• ETag 缓存目录 — 国家和地区服务在内存中缓存，TTL 为 5 分钟，并基于 ETag 进行条件刷新 — 绝不会发送给代理
• 人性化输入 — 使用 "Israel" 或 "Telegram" 而非 ID；名称在服务器端自动解析
• 双传输协议 — 单一代码库同时支持 stdio 和 http
• API 密钥认证 — 兼容您现有的 Platfone API 密钥

安装

请参阅完整的安装指南以获取详细说明。

快速开始

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

代理指南

• 始终先调用 check_price 以验证费用和可用性
• 然后调用 order_number 租用一个号码
• 调用 check_sms 直到收到短信或过期
• 如果没有收到短信，使用 retry_activation
• 如果不再需要，使用 cancel_activation 释放资金

工具

工具	描述
get_balance	检查账户余额：总额、预留资金和可用资金。
check_price	在订购前检查特定国家 + 服务组合的价格和可用性。
order_number	订购一个虚拟电话号码。接受名称（"Israel"）或 ID（"il"）。返回 activation_id + phone。
check_sms	轮询激活状态。收到短信时返回验证码，或返回当前状态及轮询指令。
retry_activation	请求在同一号码上发送另一条短信。免费。
cancel_activation	在收到短信前取消激活。退还预留金额。

注意： 国家和地区服务目录在服务器端缓存，并从人类可读的名称自动解析。 代理永远不会收到完整的目录 — 仅接收解析后的 ID 或消歧提示。

典型的 AI 代理流程

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

可选步骤：

• retry_activation — 请求在同一号码上发送另一条短信（免费）
• cancel_activation — 在短信到达前取消（退还余额）

开发

阅读完整的开发指南以获取设置说明和测试技巧。

故障排除

错误	解决方案
UnauthorizedException	检查您的 PLATFONE_API_KEY 是否有效
PaymentRequiredException	为您的 Platfone 账户充值
NoNumbersAvailableException	尝试不同的国家或服务
TooManyRequestsException	受到速率限制 — 等待并重试
MaxPriceExceededException	使用建议的 max_price 和返回的 order_id 重试 order_number
TooManyActivationsException	达到最大并发活跃激活数 — 取消或等待过期

许可证

请参阅 LICENSE.md。基于 MIT 许可证授权。

使用 Platfone API 须遵守服务条款和隐私政策。