Android Texter

Android Texter MCP 服务

让 Claude、Cursor、Windsurf 和其他 MCP 客户端通过 Android Texter 收发短信。

Android Texter 可将你自己的 Android 手机变成 SMS 和 MMS 网关。短信通过手机的真实号码和运营商套餐发出，回复则会送达你的账户。本服务会将 AI 助手连接到该账户，因此你可以说“给 Sam 发短信，告诉他会议改到下午 3 点了”或“昨天的群发消息有哪些人回复了？”，然后手机就会完成操作。

• 使用你自己的号码发送，而非共享短号码或租用号码
• 查看对话、搜索消息历史记录并管理联系人
• 安排稍后发送短信，也可以取消
• 通过 stdio 在本地运行；你的 API 密钥会保留在电脑上

开始之前

1. 注册 Android Texter 账户，在 Android 手机上安装应用并与账户配对。请访问 androidtexter.com 注册。
2. 获取 API 密钥。在控制面板中打开 Settings > API Keys（androidtexter.com/dashboard/settings/api-keys）并创建密钥。密钥以 atx_ 开头。
3. 安装 Node.js 18 或更高版本（node --version）。

安装

本服务通过 npx 运行，无需手动安装。选择下方的客户端，并将 atx_YOUR_API_KEY 替换为你的密钥。

Claude Desktop

打开 Settings > Developer > Edit Config（也可以直接编辑 claude_desktop_config.json：macOS 上的路径为 ~/Library/Application Support/Claude/，Windows 上的路径为 %APPDATA%\Claude\），并添加：

{
  "mcpServers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": {
        "ATX_API_KEY": "atx_YOUR_API_KEY"
      }
    }
  }
}

重启 Claude Desktop。Android Texter 工具会显示在新对话的工具菜单中。

Claude Code

claude mcp add android-texter --scope user --env ATX_API_KEY=atx_YOUR_API_KEY -- npx -y android-texter-mcp

运行 claude mcp list，检查是否已连接。

Cursor

添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": {
        "ATX_API_KEY": "atx_YOUR_API_KEY"
      }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json（或打开 Settings > Cascade > MCP Servers > View raw config）：

{
  "mcpServers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": {
        "ATX_API_KEY": "atx_YOUR_API_KEY"
      }
    }
  }
}

VS Code

添加到 .vscode/mcp.json。VS Code 会提示你输入密钥一次，并安全地存储密钥：

{
  "inputs": [
    { "type": "promptString", "id": "atx-api-key", "description": "Android Texter API key", "password": true }
  ],
  "servers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": { "ATX_API_KEY": "${input:atx-api-key}" }
    }
  }
}

其他 MCP 客户端

运行 npx -y android-texter-mcp，将其作为 stdio 服务，并在环境中设置 ATX_API_KEY。

在 Windows 上，如果客户端找不到 npx，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "android-texter-mcp"]。

不使用 npm

同一服务也可以从控制面板以单个文件的形式获取（Settings > Integrations > Download Script）。将其保存到任意位置，并使用 "command": "node" 和 "args": ["/absolute/path/to/android-texter-mcp.js"] 替代上方的 npx 行。

环境变量

变量	必需	描述
ATX_API_KEY	是	你的 Android Texter API 密钥，可在 Settings > API Keys 中获取。
ATX_API_BASE	否	API 根 URL。默认值为 https://androidtexter.com/api。仅在使用测试后端时更改。
ATX_CLIENT_NAME	否	在 API Keys 活动日志中显示的此连接名称。大多数客户端会自动检测。

工具

工具	功能
list_devices	已配对手机及其在线状态、电量、号码和 SIM 卡。
list_conversations	最近的对话，可按文件夹筛选：全部、收件箱（已回复）、发件箱（尚未回复）、已归档、垃圾邮件。
get_conversation	按电话号码或会话线程获取某个对话中的消息（也包括群组）。
search_messages	按关键词、号码或联系人姓名搜索所有已发送和已接收的短信。
send_message	立即或定时从指定手机和 SIM 卡发送短信或图片消息（MMS）。填写多个号码可创建群发短信。
send_broadcast	向最多 500 个号码发送短信，每个号码单独收到一条消息，并支持 {{name}} 格式的个性化内容。
get_message_status	查询已发送消息是否处于排队中、已发送、已送达或发送失败状态。
list_scheduled_messages	查看稍后发送的待发送消息。
cancel_scheduled_message	在定时消息发送前取消它。
list_contacts	列出或搜索联系人，或查找带有某个标签的所有联系人。
list_contact_tags	列出联系人正在使用的所有标签。
save_contact	按电话号码创建或更新联系人。未填写的字段会保留；标签会追加。

发送工具会从你的号码向真实的人发送真实短信。好的客户端会在调用前征求确认；你也可以在客户端的工具设置中将其设为始终征求确认。

示例提示词

• “我的哪些手机处于在线状态？”
• “显示最近 10 条已收到回复的对话。”
• “读取我与 +1 555 123 4567 的对话并起草回复。”
• “给 +15551234567 发短信：我会晚到 10 分钟，一会儿见。”
• “安排明天东部时间上午 9 点给 +15559876543 发短信：早上好！”
• “查找本周发过 interested 这个词的所有人。”
• “将 +15551112222 添加为 Dana Lee，所属公司为 Acme，标签为 vip。”
• “给所有带有 vip 标签的人发消息：嗨，{{first_name|there}}，抢先体验今天开放。”

故障排除

• “ATX_API_KEY is not set”或“Invalid API key”：检查客户端配置中的密钥，并确认它未在 API Keys 页面上被删除。
• “No devices registered”：先在 Android Texter 应用中配对手机。
• 消息一直处于排队状态：手机处于离线状态，或应用未运行。请在手机上打开应用。无法在 24 小时内发出的消息会标记为发送失败。
• “Daily message limit reached”：免费计划有每日上限。请在控制面板的 Billing 页面升级。

帮助：[email protected]。API 参考：androidtexter.com/docs。

开发

npm install
npm run typecheck
npm run build            # build/index.js, the npm bin
npm run build:download   # also copies it to the dashboard download in the Android Texter monorepo

许可证

MIT