phone-mcp

🚀 联系人创建工具

本工具借助 ADB 让您能轻松在 Android 设备上创建联系人，通过 Python 脚本实现自动化管理，操作简单且功能实用。

🚀 快速开始

下载与安装 ADB

1. 下载 ADB：访问 Android 开发者官网 下载适配您操作系统的 ADB 工具包。
2. 解压文件：把下载的工具包解压到电脑，保证 platform-tools 文件夹涵盖所有必要可执行文件（如 adb.exe）。
3. 添加环境变量：
   • Windows：将 platform-tools 路径添加到系统路径变量。
   • macOS/Linux：把 platform-tools 添加到 ~/.bashrc 或 ~/.zshrc 文件。

连接设备

1. 开启调试模式：
   • 在 Android 设备上，依次打开如下设置：

   设置 -> 系统 -> 关于手机 -> 软件信息 -> 重复点击“版本号”七次 -> 开发者选项
   

   • 启用“USB 调试”和“允许模拟器的网络代理”。
2. 连接设备：
   • 用 USB 数据线把 Android 设备和电脑相连。
   • 打开命令行工具（如 Windows 的 CMD 或 macOS/Linux 的终端）。
   • 输入以下命令检查设备是否正确连接：

   adb devices
   

   • 若设备列表显示您的设备，即连接成功。

验证安装

1. 运行示例命令：
   • 在命令行工具中输入以下命令，验证 ADB 是否正常工作：

   adb shell pm list packages
   

   • 若输出设备上的应用列表，表明 ADB 已正确安装并配置。

📦 安装指南

上述快速开始部分已详细阐述了 ADB 的下载、安装、设备连接及验证安装的步骤，按照这些步骤操作，您就能完成 ADB 的安装与配置。

✨ 主要特性

• 借助 ADB 和 Python 脚本，可在 Android 设备上自动化创建联系人。
• 支持基本用法创建默认联系人，也支持高级用法自定义账户名和类型。
• 能输出包含操作结果和错误信息的 JSON 对象，便于查看和处理。

💻 使用示例

基本用法

直接运行脚本：

python create_contact.py

这将创建一个默认的联系人，具体信息如下：

• 账户名："你的账户名"
• 账户类型： "com.google"

高级用法

您可以提供自定义账户名和类型，使用 JSON 字符串：

python create_contact.py '{"account_name": "your_account", "account_type": "com.google"}'

📚 详细文档

输出

脚本输出一个 JSON 对象，包含以下内容：

• success：布尔值，表示操作是否成功。
• message：来自命令的任何输出或错误信息。

示例输出（成功）

{"success": true, "message": ""}

错误处理

• 若 ADB 不可用或设备未连接，脚本将返回一个错误。
• 无效的 JSON 输入会导致错误消息。
• 任何 ADB 命令错误都会被捕获并记录在 message 字段中。

注意事项

⚠️ 重要提示

• 确保您的 Android 设备已连接且授权 ADB 使用。
• 设备屏幕应处于解锁状态。
• 部分设备可能需要额外权限才能创建联系人。

🔧 技术细节

Python 脚本示例

以下是用于通过 ADB 创建联系人的 Python 脚本：

import os

def create_contact(account_name, account_type):
    # 启动添加联系人活动
    os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")
    
    # 等待设备响应（可调时间根据需要）
    import time
    time.sleep(2)
    
    # 输入账户名
    os.system(f"adb shell input text {account_name}")
    
    # 设置账户类型
    os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")
    
    # 保存联系人
    os.system("adb shell keyevent 66")  # 按下“确定”键

# 示例用法
create_contact("your_account", "com.google")

代码说明

1. 启动添加联系人活动：

os.system("adb shell am start -a android.intent.action.ADD_VIA_ADDRESS")

2. 输入账户名：

os.system(f"adb shell input text {account_name}")

3. 设置账户类型：

os.system(f"adb shell content insert --uri content://com.android.contacts/contacts --values name={account_type}")

4. 保存联系人：

os.system("adb shell keyevent 66")

扩展说明

• 修改账户类型：您可以将 account_type 参数替换为其他类型的账户，例如 "com.yahoo" 或 "com.microsoft"。
• 自定义输入逻辑：根据需要调整输入时间和命令。
• 批量创建联系人：可以编写循环脚本以批量添加多个联系人。

📚 常见问题解答

1. 如何验证 ADB 是否正常工作？

在命令行工具中运行以下命令：

adb devices

如果设备列表中显示了您的设备，则表示 ADB 已正确配置。

2. 设备未出现在 adb devices 列表中怎么办？

• 确保设备已启用 USB 调试。
• 尝试重新连接设备。
• 检查是否安装了正确的 USB 驱动程序。

3. 如何解决 ADB 权限问题？

在命令行工具中运行以下命令：

adb shell pm grant com.android.contacts.permission.WRITE_CONTACTS

4. 脚本无法创建联系人怎么办？

检查是否有足够的设备权限，并确保账户类型正确无误。

总结

通过 ADB 和 Python 脚本，您可以自动化管理 Android 设备上的联系人。本文详细介绍了 ADB 的安装与配置方法，并提供了使用 Python 脚本来实现联系人自动添加的功能示例。希望这些内容对您有所帮助！