AVA MCP Server

モデルコンテキストプロトコル（MCP）

すべてのクレジット: https://github.com/ShawhinT/YouTube-Blog/

AIエージェントシリーズの4番目の例です。ここでは、顧客向けMCPサーバーを構築し、あらゆるAIアプリが人工仮想アシスタント（AVA）のツールセットにアクセスできるようにします。

リンク

• ビデオ
• ブログ

この例を実行する方法

1. このリポジトリをクローンする
2. まだインストールしていない場合はuvをインストールしてください

3. 開発モードでサーバーをテストする

4. AI アプリ (例: Claude Desktop または Cursor) にサーバー構成を追加します。

AVAの動作のカスタマイズ

個人情報と設定を更新する

1. プロジェクトディレクトリ内のprompts/ava.mdファイルを見つけます。
2. 次のファイルを使用してカスタマイズします。
   • コミュニケーションの設定
   • タスク処理に関する具体的な指示
   • AVAに関するその他の関連ガイドライン

環境設定 (.env)

1. 次の変数を使用して、プロジェクトのルート ディレクトリに.envファイルを作成します。

必要な環境変数:

• USER_EMAIL : このアプリケーションで使用するGmailアドレス
• GOOGLE_CREDENTIALS_PATH : Google OAuth 認証情報ファイルへのパス
• GOOGLE_TOKEN_PATH : Google OAuthトークンが保存されるパス

Google OAuth 設定

1. プロジェクトディレクトリ構造を作成する

まず、必要なディレクトリ構造を作成します。

2. Google Cloud プロジェクトを設定する

1. Google Cloud Consoleにアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
3. Gmail API を有効にします。
   • ナビゲーションメニューで、「APIとサービス」>「ライブラリ」に移動します。
   • 「Gmail API」を検索
   • 「有効にする」をクリックします

3. OAuth認証情報を作成する

1. Google Cloud Console の場合:
   • 「APIとサービス」>「認証情報」に移動します
   • 「認証情報を作成」>「OAuthクライアントID」をクリックします
   • アプリケーションの種類として「デスクトップアプリケーション」を選択します
   • 名前を付けます（例：「AVA Gmail クライアント」）
   • 「作成」をクリック
2. 資格情報をダウンロードします:
   • 作成後、「JSONをダウンロード」をクリックします。
   • ダウンロードしたファイルを.config/ava-agent/にcredentials.jsonとして保存します。
   • ファイルにはクライアントIDとクライアントシークレットが含まれている必要があります

4. OAuth同意画面を設定する

1. Google Cloud Console の場合:
   • 「APIとサービス」>「OAuth同意画面」に移動します
   • 「外部」ユーザータイプを選択
   • 必要な情報を入力してください:
     • アプリ名
     • ユーザーサポートメール
     • 開発者の連絡先情報
   • Gmail API スコープを追加します: https://www.googleapis.com/auth/gmail.modify
   • テストユーザーとしてメールアドレスを追加する
   • 設定を完了する

Googleにログインする

サーバーがGmailアカウントにアクセスする前に、承認が必要です。これはuv run oauth.pyを実行することで実行できます。このコマンドは、以下の処理を実行します。

1. token.jsonの存在を確認する
2. 見つからない場合は、Google OAuth認証フローを開始します。
3. ブラウザでの認証プロセスをガイドします。
   • Googleアカウントにログインするよう求められます
   • 要求された権限を付与する
   • アプリケーションはトークンを自動的に保存します
4. トークンを自動的に生成して保存する

セキュリティノート

ファイル保護

• .envファイルやtoken.jsonをバージョン管理にコミットしないでください。
• Google認証情報を安全に保つ
• .gitignoreに以下を追加します:
  .env .config/ava-agent/token.json .config/ava-agent/credentials.json