Google Chat MCP Server

🚀 MCP（モデル制御プロトコル）サーバのGoogle Chat統合プロジェクト

このプロジェクトは、MCP（モデル制御プロトコル）サーバにGoogle Chatの統合機能を提供します。PythonとFastMCPで作成されており、MCPツールを通じてGoogle Chatのスペースやメッセージにアクセスし、対話することができます。ユーザーは自分のGoogle Chatデータ（スペースやメッセージ）を閲覧および管理することが可能です。

🚀 クイックスタート

Google OAuthログインの準備

1. このプロジェクトをクローンします：

   git clone https://github.com/chy168/google-chat-mcp-server.git
   cd google-chat-mcp-server
   

2. Google Cloudプロジェクト（GCP）を作成します。
3. Googleクラウドコンソール (https://console.cloud.google.com/auth/overview?project=<YOUR_PROJECT_NAME>) にアクセスします。
4. 「認証プラットフォーム > クライアント > (+) クライアントを作成」でWebアプリケーションタイプのクライアントを作成します。
   • 参考ドキュメント：https://developers.google.com/identity/protocols/oauth2/?hl=en
   • 承認済みのJavaScriptオリジンを追加：http://localhost:8000
   • 承認済みのリダイレクトURIを追加：http://localhost:8000/auth/callback
5. OAuth 2.0クライアントを作成したら、クライアントの認証情報ファイル（.json形式）をダウンロードし、プロジェクトのルートディレクトリにcredentials.jsonとして保存します。

認証サーバを実行してGoogleアクセストークンを取得する

python server.py -local-auth --port 8000

• ブラウザを開いて http://localhost:8000/auth にアクセスします。
• Googleアカウントでログインします！
• ログインが完了すると、アクセストークンがtoken.jsonとして保存されます。

MCP設定（mcp.json）

プロジェクトのルートディレクトリにmcp.jsonファイルを作成または編集し、以下の内容を追加します：

{
    "mcpServers": {
        "google_chat": {
            "command": "uv",
            "args": [
                "--directory",
                "<YOUR_REPO_PATH>/google-chat-mcp-server",
                "run",
                "server.py",
                "--token-path",
                "<YOUR_REPO_PATH>/google-chat-mcp-server/token.json"
            ]
        }
    }
}

開発とデバッグ

fastmcp dev server.py --with-editable .

✨ 主な機能

• OAuth 2.0を使用したGoogle Chat APIの認証
• アクセス可能なGoogle Chatスペースの一覧表示
• 特定のスペースから日付でフィルタリングしてメッセージを取得
• 独立した認証サーバによる簡単なデプロイ

📦 インストール

• Python 3.8以上が必要です。
• Chat APIを有効にしたGoogle Cloudプロジェクトが必要です。
• Google CloudコンソールのOAuth2認証情報が必要です。

💻 使用例

基本的な使用法

# Google Chatスペースの一覧を取得
from server import get_chat_spaces
spaces = get_chat_spaces()
print(spaces)

# 特定のGoogle Chatスペースからメッセージを取得
from server import get_space_messages
messages = get_space_messages("space_name", "start_date", "end_date")
print(messages)

📚 ドキュメント

プロジェクト構造

このプロジェクトは2つの主要なコンポーネントを含んでいます：

1. Google Chatツール付きのMCPサーバ：Google Chatとの対話ツールを提供します。

   • FastMCPで作成されています。
   • server.py：MCPのメインサービスを実装し、Google Chatツールを統合しています。
   • google_chat.py：Google Chat APIの統合と認証処理を行います。

2. 認証サーバ：Googleアカウントの認証を行う独立したコンポーネントです。

   • FastAPIで作成されています。
   • OAuth2とGoogleの対話フローを処理します。
   • アクセストークンを保存および管理します。
   • 単独で実行するか、MCPサービスの一部として実行することができます。
   • server_auth.py：認証サーバを実装しています。

認証フローを通じて、Google APIトークンを取得および更新することができ、これらのトークンはMCPツールがGoogle Chatデータ（スペースやメッセージ）にアクセスするために使用されます。

提供されるツール

MCPサーバは以下のツールを提供します：

• get_chat_spaces()：アクセス可能なすべてのGoogle Chatスペースを一覧表示します。
• get_space_messages(space_name: str, start_date: str, end_date: str = None)：特定のGoogle Chatスペースからメッセージを取得し、日付範囲でのフィルタリングをサポートします。