Androidapi.net Mcp

AndroidAPI.net MCP 连接器

适用于 AndroidAPI.net 的 Model Context Protocol (MCP) 连接器，可让 Claude 通过已关联的 Android 设备或网关额度发送 SMS、WhatsApp 消息和 OTP、管理联系人、运行 USSD 代码等。

---

功能

• 52 个工具，覆盖 AndroidAPI.net 的每个 API 端点
• 所有工具均以 androidapi_ 为前缀，与其他 MCP 服务不冲突
• 完整的工具注解（readOnlyHint、destructiveHint 等）
• 适用于 Claude Desktop、Claude Code 和任何兼容 MCP 的宿主
• TypeScript 源代码，除官方 MCP SDK 外无运行时依赖

工具类别

类别	工具
账户	androidapi_get_credits · androidapi_get_subscription
合作伙伴	androidapi_get_earnings
联系人	androidapi_get_contacts · androidapi_create_contact · androidapi_delete_contact · androidapi_get_groups · androidapi_create_group · androidapi_delete_group · androidapi_get_unsubscribed · androidapi_delete_unsubscribed
OTP	androidapi_send_otp · androidapi_verify_otp
SMS	androidapi_send_sms · androidapi_send_sms_bulk · androidapi_get_sms_sent · androidapi_get_sms_received · androidapi_get_sms_pending · androidapi_get_sms_message · androidapi_get_sms_campaigns · androidapi_start_sms_campaign · androidapi_stop_sms_campaign · androidapi_delete_sms_sent · androidapi_delete_sms_received · androidapi_delete_sms_campaign
网关	androidapi_get_rates
WhatsApp	androidapi_send_whatsapp · androidapi_send_whatsapp_bulk · androidapi_get_wa_accounts · androidapi_get_wa_sent · androidapi_get_wa_received · androidapi_get_wa_pending · androidapi_get_wa_message · androidapi_get_wa_campaigns · androidapi_get_wa_groups · androidapi_get_wa_group_contacts · androidapi_validate_whatsapp_phone · androidapi_link_whatsapp_account · androidapi_relink_whatsapp_account · androidapi_get_wa_servers · androidapi_start_wa_campaign · androidapi_stop_wa_campaign · androidapi_delete_wa_sent · androidapi_delete_wa_received · androidapi_delete_wa_campaign · androidapi_delete_wa_account
Android	androidapi_get_devices · androidapi_delete_notification · androidapi_send_ussd · androidapi_get_ussd · androidapi_delete_ussd
其他	androidapi_get_shorteners

---

前提条件

1. 一个 AndroidAPI.net 账户
2. 从控制面板的 Tools → API Keys 获取 API 密钥
3. Node.js 18 或更高版本

---

安装

选项 A — npx（推荐，无需安装）

{
  "mcpServers": {
    "androidapi": {
      "command": "npx",
      "args": ["-y", "androidapi-mcp"],
      "env": {
        "ANDROIDAPI_SECRET": "YOUR_API_SECRET"
      }
    }
  }
}

选项 B — 全局安装

npm install -g androidapi-mcp

{
  "mcpServers": {
    "androidapi": {
      "command": "androidapi-mcp",
      "env": {
        "ANDROIDAPI_SECRET": "YOUR_API_SECRET"
      }
    }
  }
}

---

Claude Desktop 配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS） 或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "androidapi": {
      "command": "npx",
      "args": ["-y", "androidapi-mcp"],
      "env": {
        "ANDROIDAPI_SECRET": "YOUR_API_SECRET_HERE"
      }
    }
  }
}

重启 Claude Desktop。androidapi_* 工具将出现在 Claude 的工具列表中。

---

Claude Code 配置

claude mcp add androidapi -- npx -y androidapi-mcp

然后在 ~/.claude/settings.json 或 shell 配置文件中设置密钥：

{
  "mcpServers": {
    "androidapi": {
      "command": "npx",
      "args": ["-y", "androidapi-mcp"],
      "env": {
        "ANDROIDAPI_SECRET": "YOUR_API_SECRET_HERE"
      }
    }
  }
}

---

示例提示词

连接后，询问 Claude：

• "使用我的设备向 +923012345678 发送短信，内容为“您的订单已准备就绪”
• "通过 WhatsApp 向 +923001234567 发送 OTP，并在对方回复后验证"
• "创建一个名为“VIP Customers”的联系人群组，并将这些号码添加到其中"
• "向我的 Marketing 群组发送包含此促销消息的 WhatsApp 群发活动"
• "检查我剩余的 AndroidAPI 额度"
• "在我的 Android 设备的 SIM 1 上拨打 *123#，并向我显示结果"
• "关联一个新的 WhatsApp 账户——显示要扫描的二维码"
• "列出我今天发送的所有短信"

---

配置参考

环境变量	必需	说明
ANDROIDAPI_SECRET	✅	你在 AndroidAPI.net → Tools → API Keys 中获取的 API 密钥

---

开发

git clone https://github.com/tecniforge/androidapi-mcp
cd androidapi-mcp
npm install
npm run build
ANDROIDAPI_SECRET=your_key npm start

项目结构

src/
├── index.ts      # MCP server entry point & error handling
├── tools.ts      # Tool definitions with schemas and annotations
├── handlers.ts   # Routes tool calls to API endpoints
├── client.ts     # Typed HTTP client (GET / multipart / URL-encoded)
└── types.ts      # TypeScript interfaces for API responses

使用 MCP Inspector 测试

ANDROIDAPI_SECRET=your_key npx @modelcontextprotocol/inspector node dist/index.js

---

许可证

MIT — 请参阅 LICENSE

---

Claude Cowork 插件

更喜欢无需编写代码的体验？安装 AndroidAPI.net Cowork Plugin——一套现成的 Claude Cowork 技能，通过自然语言命令封装此连接器。

• /send-sms · /send-whatsapp · /send-otp · /manage-contacts · /sms-campaigns · /whatsapp-campaigns

下载 Cowork 插件 →
插件仓库 →

---

链接

• AndroidAPI.net — 官方网站和控制面板
• AndroidAPI.net API 文档 — 完整的 API 参考
• 完整文档 — 设置指南、工具参考和故障排除
• MCP 文档 — Model Context Protocol 规范
• TecniForge — 由 TecniForge 构建
• [email protected]