smsportal.app SMS

smsportal.app MCP 服务

通过 Claude、Cursor 或任何其他 Model Context Protocol 客户端，使用你自己的 Android 手机收发 SMS。

smsportal.app 可将 Android 手机变为 SMS 网关：消息通过你自己的号码和 SIM 卡发出，收到的 SMS 则可通过 API 获取。此服务会向 AI Agent 开放该账户。它与南非的 SMSPortal (Pty) Ltd 无关。

使用托管服务（推荐）

1. 在 smsportal.app 创建账户，配对你的 Android 手机，并在控制面板中创建 API 密钥。
2. 将服务添加到你的客户端。

Claude Code

claude mcp add --transport http smsportal https://smsportal.app/mcp \
  --header "Authorization: Bearer $SMSPORTAL_API_KEY"

Claude Desktop 和其他不支持自定义标头的客户端（通过 mcp-remote，需要 Node.js 18+）

{
  "mcpServers": {
    "smsportal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://smsportal.app/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_SMSPORTAL_API_KEY" }
    }
  }
}

分步指南：smsportal.app/en/integrations/mcp。

工具

工具	功能
smsportal_list_devices	查看与账户配对的手机，以及其上次心跳时间和 SIM 状态
smsportal_get_stats	已发送、已接收消息及设备总数
smsportal_list_messages	按文本、号码、手机、状态和时间搜索已发送及已接收的 SMS
smsportal_read_received_sms	读取手机已同步的收到的 SMS
smsportal_get_send_status	查看 smsportal_send_sms 返回的批次中每位接收者的状态
smsportal_send_sms	从你的手机向最多 50 个 E.164 号码发送准确的消息

API 接受请求并不代表消息已送达；请之后检查发送状态。设置 SMSPORTAL_READ_ONLY=true 可移除发送工具。

自行运行

git clone https://github.com/aleksanderem/smsportal-mcp && cd smsportal-mcp
npm ci && npm run build

本地（stdio）客户端配置：

{
  "mcpServers": {
    "smsportal": {
      "command": "node",
      "args": ["/path/to/smsportal-mcp/dist/index.js"],
      "env": { "SMSPORTAL_API_KEY": "YOUR_SMSPORTAL_API_KEY" }
    }
  }
}

变量	默认值	含义
SMSPORTAL_API_KEY	—	API 密钥（stdio 模式）
SMSPORTAL_API_URL	https://smsportal.app/api/v1	API 基础 URL
SMSPORTAL_READ_ONLY	false	true 时隐藏发送工具
SMSPORTAL_PUBLIC_ORIGIN	http://localhost:18080	HTTP 模式：唯一允许的浏览器来源
SMSPORTAL_TRUST_PROXY	false	HTTP 模式：信任一个反向代理跳转，用于获取调用方地址
HOST、PORT	127.0.0.1、3002	HTTP 模式监听地址

HTTP 模式（node dist/index.js --http 或使用 Dockerfile）会在 /mcp 提供 Streamable HTTP，通过 Authorization: Bearer（或 x-api-key 标头，适用于无法添加 Bearer 前缀的主机）获取 API 密钥，在每次请求前验证密钥，并按调用方网络进行速率限制。

开发

npm ci && npm test

安全问题报告：请参阅 SECURITY.md。许可证：MIT。