MCP Google Contacts Server

🚀 MCP Google Contacts Server

MCP Google Contacts Serverは、Google People APIをベースに構築されたContacts（連絡先）管理ツールです。このツールは、Googleアカウント内の連絡先データを効率的に管理および操作するための機能を提供しており、作成、更新、削除、検索などの操作が可能です。

🚀 クイックスタート

MCP Google Contacts Serverは、Google People APIを利用してGoogleアカウントの連絡先を管理するツールです。以下の手順に従って、このツールを使用して連絡先を管理しましょう。

✨ 主な機能

• 連絡先管理：連絡先の追加、編集、削除をサポートします。
• 検索機能：名前、メールアドレス、電話番号など、複数の検索方法を提供します。
• ディレクトリ検索：組織のGoogle Workspaceディレクトリ内のユーザーを検索できます。
• その他の連絡先：連絡先リストに追加されていないが、あなたとやり取りした人を表示できます。
• 一括操作：複数の連絡先を一度に操作することができます。
• 高い拡張性：様々なアプリケーションやシステムに簡単に統合できます。

📦 インストール

依存関係のインストール

このツールを実行する前に、以下のライブラリをインストールする必要があります。

pip install google-auth google-auth-oauthlib googleapis-common-protos google-resourceliker python-dotenv

設定ファイルの作成

.envという名前のファイルを作成し、Google APIキーを追加します。

GOOGLE_API_KEY=your_api_key_here

サービスの起動

以下のコマンドを実行して、MCP Google Contacts Serverを起動します。

python main.py

📚 ドキュメント

以下は、このツールが提供する主な機能とその使用方法です。

1. 連絡先の一覧表示 (list_contacts)

• 機能：すべてのGoogle Contactsを表示するか、名前でフィルタリングします。
• パラメータ：
  • name_filter（オプション）：名前で連絡先を絞り込みます。
  • max_results（オプション）：返される最大結果数を設定します。デフォルトは100です。
• 例：

list_contacts(name_filter="张三", max_results=50)

2. 連絡先情報の取得 (get_contact)

• 機能：指定された連絡先の詳細情報を取得します。
• パラメータ：
  • identifier：連絡先のリソースID（people/*）またはメールアドレス。
• 例：

get_contact("zhangsan@example.com")
# または
get_contact("people/12345678901234567")

3. 新しい連絡先の作成 (create_contact)

• 機能：Google Contactsに新しい連絡先を追加します。
• パラメータ：
  • given_name：連絡先の名前。
  • family_name（オプション）：姓。
  • email（オプション）：メールアドレス。
  • phone（オプション）：電話番号。
• 例：

create_contact(given_name="李", family_name="四", email="lisi@example.com", phone="+86 13800138000")

4. 連絡先情報の更新 (update_contact)

• 機能：既存の連絡先の情報を変更します。
• パラメータ：
  • resource_name：連絡先のリソースID（people/*）。
  • given_name（オプション）：更新する名前。
  • family_name（オプション）：更新する姓。
  • email（オプション）：更新するメールアドレス。
  • phone（オプション）：更新する電話番号。
• 例：

update_contact(resource_name="people/12345678901234567", email="new@example.com")

5. 連絡先の削除 (delete_contact)

• 機能：指定された連絡先をGoogle Contactsから削除します。
• パラメータ：
  • resource_name：削除する連絡先のリソースID（people/*）。
• 例：

delete_contact(resource_name="people/12345678901234567")

6. 連絡先の検索 (search_contacts)

• 機能：指定された条件に基づいて連絡先を検索します。
• パラメータ：
  • query：検索キーワード。
• 例：

search_contacts(query="王五")

7. Google Workspaceディレクトリの検索 (search_directory)

• 機能：組織のGoogle Workspaceディレクトリ内のユーザーを検索します。
• パラメータ：
  • query：検索キーワード。
• 例：

search_directory(query="Marketing")

8. その他の連絡先の表示 (view_other_contacts)

• 機能：連絡先リストに追加されていないが、あなたとやり取りした人を表示します。
• 例：

view_other_contacts()

🔧 技術詳細

このツールを使用するには、以下の権限が必要です。

• 読み取り/書き込み権限：
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.write
• ディレクトリアクセス権限：
  • https://www.googleapis.com/auth/admin.directory.readonly

トラブルシューティング

一般的な問題と解決策

1. 連絡先を取得できない場合：APIキーが正しいことを確認し、Contacts APIとDirectory APIが有効になっていることを確認してください。
2. 権限が拒否された場合：アプリのOAuthスコープが正しく設定されていることを確認し、必要な承認を取得してください。
3. パフォーマンスの問題：クエリ条件を最適化し、返される結果数を制限してください。

貢献

コミュニティの皆さんからの開発への参加を歓迎します。

• 問題を報告するには、Issueを提出してください。
• コードをForkし、Pull Requestを提出してください。
• ドキュメントや翻訳を貢献してください。

リポジトリのURL： [GitHubリンク]

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細は以下の通りです。

MIT License

Copyright (c) 2023 Your Name

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

詳細については、[公式ドキュメント]を参照してください。