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デバイスで、以下の設定を順に開きます。

     設定 -> システム -> 端末情報 -> ソフトウェア情報 -> 「バージョン番号」を7回タップ -> 開発者向けオプション
     

   • 「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")  # 「OK」キーを押す

# サンプル使用法
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スクリプトを使用して連絡先を自動的に追加する機能の例を提供しました。これらの内容がお役に立てば幸いです！