Phone MCP

🚀 聯繫人創建工具

這個工具藉助 ADB 讓您能在 Android 設備上輕鬆創建聯繫人，通過自動化操作節省時間和精力。

🚀 快速開始

📦 安裝指南

下載與安裝 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 已正確安裝並配置。

💻 使用示例

基本用法

直接運行腳本：

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 腳本來實現聯繫人自動添加的功能示例。希望這些內容對您有所幫助！