EAGS4 MCP Server Client

🚀 多コンポーネントプラットフォーム（MCP）サーバとGemini AIの統合

このプロジェクトは、多コンポーネントプラットフォーム（MCP）サーバを実装し、Gemini AI機能を統合しています。これにより、ユーザーは自然言語指令を使用して様々な数学演算や複雑なタスクを実行できます。

✨ 主な機能

• 数学演算

  • 基本的な算術（加算、減算、乗算、除算）
  • 高度な数学（累乗、平方根、立方根）
  • 特殊関数（階乗、対数、三角関数）
  • リスト操作（リストの合計、指数の合計）

• 文字列処理

  • 文字列をASCII値に変換
  • 文字配列を処理

• Keynote統合

  • Keynoteアプリケーションを開く
  • カスタムサイズの矩形を描画
  • 形状内にテキストを追加

• AI駆動のタスク実行

  • Gemini AIを使用した自然言語処理
  • 反復的な問題解決
  • ユーザーのクエリに基づく自動ツール選択

📦 インストール

前提条件

• Python 3.8以上
• Google Gemini APIキー
• macOS（Keynote統合の場合）

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/your-repository.git
   

2. 仮想環境を作成し、アクティブ化します（Python 3.8以上を推奨）：

   python -m venv mcp-venv
   source mcp-venv/bin/activate  # Windowsの場合は `mcp-venv\Scripts\activate` を使用
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

📚 ドキュメント

プロジェクト構造

mcp-server/
├── server.py          # MCPサーバのメインプログラム
├── tools/            # 統合ツールのディレクトリ
│   ├── math_tool.py  # 数学演算ツール
│   └── string_tool.py# 文字列処理ツール
└── requirements.txt  # プロジェクトの依存関係リスト

使い方

サーバーの起動

python server.py

クライアントの起動

python client.py

クエリの例

• 計算：What is the sum of 10 and 20?
• 変換：Convert "Hello, World!" to ASCII.
• 矩形の描画：

  {
    "action": "draw_rectangle",
    "params": {
      "width": 500,
      "height": 300
    }
  }
  

利用可能なツール

数学演算ツール

• add: 2つの数字の合計を計算します。
• subtract: 2つの数字の差を計算します。
• multiply: 2つの数字の積を計算します。
• divide: 2つの数字の商を計算します。

文字列処理ツール

• to_ascii: 文字列をASCII表現に変換します。
• reverse: 与えられた文字列を反転します。
• uppercase: 文字列を大文字に変換します。

デモビデオ

エラー処理

システムは以下のエラー処理メカニズムを提供します：

• AI応答のタイムアウト検出
• 型変換の検証
• ツールの可用性チェック
• パラメータの有効性検証

デバッグ情報

デバッグ出力には以下が含まれます：

• ツールの実行詳細
• パラメータの処理フロー
• 結果のフォーマットステップ
• エラーメッセージとスタックトレース

コントリビュートの方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

謝辞

以下の支援に感謝します：

• Google Gemini AIによる自然言語処理機能
• MCPフレームワークによるツール管理機能
• Pythonコミュニティによる様々なライブラリ