MCP AI Agent

🚀 MCP 智能代理

このプロジェクトは、複雑な数学演算を実行し、視覚的なプレゼンテーションを作成し、Google サービスを通じて電子メールで結果を送信することができる智能エージェントを展示しています。複数の MCP（モデルコンテキストプロトコル）サーバーが連携して複合タスクを解決する能力を示しています。

🚀 クイックスタート

この MCP 智能エージェントを使用することで、複雑なタスクを自動化して解決することができます。以下の手順に従って、セットアップと使用を行ってください。

✨ 主な機能

• 複雑な数学演算（斐波那契数列の計算や指数演算など）を実行します。
• Google スライドを使用して視覚的なプレゼンテーションを作成します。
• Gmail を通じて結果を電子メールで送信します。

📦 インストール

前提条件

• Python 3.8 以上
• Linux/Unix 環境（Linux 5.15.0 - 136 - generic でテスト済み）
• X11 表示サーバー（スライド機能に必要）
• Gmail と Google スライドにアクセスできる Google アカウント

インストール手順

1. リポジトリをクローンします。
2. 依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

Google API の設定

1. Gmail の設定：

   • Google Cloud Console でプロジェクトを作成します。
   • Gmail API を有効にします。
   • OAuth 2.0 の認証情報を作成します。
   • 認証情報を mcp_servers/credentials.json として保存します。

2. 環境変数（オプション）：

   • GMAIL_CREDS_FILE：認証情報ファイルのパス
   • GMAIL_TOKEN_FILE：トークンファイルのパス

使用方法

1. エージェントを起動します。

python agent.py

2. システムは以下の操作を実行します。
   • 斐波那契数列と指数値を計算します。
   • 結果を含むスライドを作成します。
   • スライドを content/slide.png として PNG ファイルに保存します。
   • PNG ファイルを添付した電子メールを送信します。

システムアーキテクチャ

システムは 3 つの主要な MCP サーバーで構成されています。

1. 数学サーバー (mcp_servers/math_server.py)

   • 斐波那契数列を計算します。
   • 指数演算を実行します。
   • 数学計算を処理します。

2. スライドサーバー (mcp_servers/slides_server.py)

   • Google スライドのプレゼンテーションを作成します。
   • スライドにテキストを追加します。
   • スライドを PNG 画像ファイルとしてダウンロードします。

3. Gmail サーバー (mcp_servers/gmail_server.py)

   • 添付ファイル付きの電子メールを送信します。
   • 電子メール操作（読み取り、ゴミ箱に移動、既読としてマークなど）を管理します。
   • Gmail API の認証を処理します。

プロジェクト構造

.
├── agent.py              # メインエージェントの実装ファイル
├── ai.py                 # Gemini とのやり取り
├── prompt.py             # プロジェクトで使用するプロンプト
├── mcp_servers/
│   ├── slides_server.py  # Google スライドの操作
│   ├── gmail_server.py   # Gmail の操作
│   └── math_server.py    # 数学計算
├── content/              # 生成されたコンテンツ（スライド、画像）
└── requirements.txt      # プロジェクトの依存関係

トラブルシューティング

• 表示問題：X11 表示サーバーが実行されていることを確認してください。
• Gmail の認証：
  • 初回実行時に Google アカウントのアクセス権限が求められます。
  • 認証に失敗した場合は、token.json ファイルを削除してから再度試してください。
• ファイルパス：
  • 画像は content/slide.png に保存されます。
  • ファイルの位置を指定する場合は、絶対パスを使用してください。

出力例

エージェントを実行すると、以下のような結果が得られます。

1. コンソールに数学計算の結果が表示されます。
2. コンテンツディレクトリに PNG ファイルが作成されます。
3. PNG ファイルを添付した電子メールを受信します。

実行ログ