Eagv1 S4 MCP

🚀 数学演算エージェント（Microsoft Word と Gmail を統合）

Python ベースの数学演算エージェントで、様々な数学ツールを使って問題を反復的に解き、Microsoft Word と Gmail を用いて結果を可視化します。

✨ 主な機能

数学演算

• 基本的な算術演算（加算、減算、乗算、除算）
• 高度な演算（累乗、平方根、立方根）
• 三角関数（正弦、余弦、正接）
• 対数計算
• 階乗計算
• フィボナッチ数列の生成
• ASCII 値の変換
• 指数和の計算

人工知能の統合

• Google Gemini Pro モデルを使用したスマートな問題解決
• 反復的な問題解決手法
• 自動ツール選択と実行

強化されたログ記録

• 詳細な実行ログ
• ツール操作のデバッグ情報
• エラーの追跡と報告
• 実行履歴を含む総合的な電子メールレポート

電子メールの統合

• 完了後に自動で電子メールレポートを送信
• メール本文に詳細な実行ログを含む
• 最終結果の要約
• Gmail SMTP の統合

Word の統合

• Word 文書を自動生成
• 結果の矩形描画
• 結果の自動可視化
• テキスト位置の設定

📦 インストール

前提条件

• Python 3.7 以上
• macOS 上の Microsoft Word
• macOS 10.15 以上
• Google Cloud API キー（Gemini Pro 用）

インストール手順

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

pip3 install -r requirements.txt

3. 環境変数を設定します。

オプション 1：ターミナルでエクスポートする（テストに推奨）：

export GEMINI_API_KEY=your_api_key_here
export GMAIL_USER=your.email@gmail.com
export GMAIL_APP_PASSWORD=your16digitpassword

オプション 2：.env ファイルを作成する：

GEMINI_API_KEY=your_api_key_here
GMAIL_USER=your.email@gmail.com
GMAIL_APP_PASSWORD=your16digitpassword

💻 使用例

基本的な使用法

推奨方法：クライアントを実行する（サーバーを自動起動）：

python math_agent_client.py

高度な使用法

デバッグ方法（オプション）：サーバーとクライアントを別々に実行する：

1. MCP サーバーを起動する：

# ターミナル 1
python math_agent_server.py

# ターミナル 2
python math_agent_client.py

エージェントは以下の操作を行います：

• 内部で MCP サーバーを起動
• Gemini AI を使用して数学的なクエリを処理
• 利用可能なツールを使って計算を実行
• 結果を含む Word 文書を作成
• 最終的な答えを表示するための矩形を描画
• 実行ログを含む電子メールレポートを送信

クエリの例

- INDIA の文字の ASCII 値を検索し、それらの値の指数和の結果の合計を返す
- 5 の階乗を計算する
- 最初の 10 個のフィボナッチ数の合計を求める

📚 ドキュメント

アーキテクチャ

• math_agent_client.py : メインクライアントで、以下の処理を行います：

  • Gemini AI の統合
  • クエリの処理
  • ツールの実行
  • Word での結果の可視化

• math_agent_server.py : サーバーで、以下を提供します：

  • 数学ツール
  • Word 統合ツール
  • リソースプロセッサ

エラー処理

• AI 生成の有効性に対するタイムアウト保護
• ツール実行の堅牢なエラー処理
• 自動状態リセット
• デバッグログ記録

ログ記録

• すべての操作はタイムスタンプ付きで記録されます。
• ログレベル：INFO、DEBUG、ERROR
• ログは電子メールレポートに含まれます。
• コンソール出力はリアルタイム監視に使用されます。

トラブルシューティング

電子メールの設定

• GMAIL_USER が完全な電子メールアドレスであることを確認してください。
• GMAIL_APP_PASSWORD は 16 文字の「アプリ」パスワードである必要があります。
• Google アカウントの 2 段階認証を有効にしてください。
• 詳細なエラー情報を取得するには、実行ログを確認してください。

Word の統合

• Microsoft Word がインストールされ、システム上で正しく設定されていることを確認してください。
• エージェントを実行するユーザーが Word のインストールディレクトリにアクセスできる権限を持っていることを確認してください。

注意事項

• このエージェントは Gemini AI サービスを使用するためにインターネット接続が必要です。
• 初回使用前にすべての依存関係が正しくインストールされていることを確認することをお勧めします。
• 問題が発生した場合は、ログファイルを確認するか、サポートチームに連絡してください。