Multi-MCP AI Agent

マルチMCP AI エージェント

基本的な数学演算から、Google Workspace やウェブスクレイピングなどの高度な外部サービス連携まで、幅広い機能を提供するために複数の MCP（Model Control Protocol）サーバーを活用するエージェント型 AI エージェントシステムです。Telegram ボットインターフェースと、リアルタイム通信のための Server-Sent Events（SSE）を備えています。

🌟 特長

• マルチMCPアーキテクチャ：分散処理と多様な機能を実現するために、複数の MCP サーバーを活用します
• 認知モジュール：知覚、意思決定、記憶、行動の各モジュールを実装します
• 外部サービス連携：
  • Google Workspace（Gmail、Google Drive、Google Sheets）
  • ウェブスクレイピングとコンテンツ抽出
  • DuckDuckGo 検索連携
• リアルタイム通信：
  • Telegram ボットインターフェース
  • ライブ更新用の Server-Sent Events（SSE）
• 主要コンポーネント：
  • エージェントループ管理
  • セッション処理
  • コンテキスト管理
  • 戦略的な意思決定

🏗️ プロジェクト構成

├── agent.py              # Main agent entry point
├── core/                 # Core agent components
│   ├── context.py        # Context management
│   ├── loop.py           # Main agent loop
│   ├── session.py        # Session handling
│   └── strategy.py       # Strategic decision making
├── modules/              # Cognitive modules
│   ├── action.py         # Action execution
│   ├── decision.py       # Decision making
│   ├── memory.py         # Memory management
│   ├── model_manager.py  # Model management
│   ├── perception.py     # Input processing
│   └── tools.py          # Tool definitions
├── config/               # Configuration files
│   ├── models.json       # Model configurations
│   └── profiles.yaml     # MCP server profiles
└── mcp_server_*.py       # MCP server implementations

🚀 はじめに

前提条件

• Python 3.11+
• UV パッケージマネージャー
• Telegram ボットトークン（ボット機能用）
• Google Cloud 認証情報（Google Workspace 連携用）

インストール

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

git clone <repository-url>
cd <repository-name>

2. 仮想環境を作成して有効化します：

uv venv
venv\Scripts\activate  # On Mac: source venv/bin/activate

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

uv sync

4. 環境変数を設定します：
   • Gemini API キーと Telegram ボットトークンを含む .env を作成します。
   • Google OAuth クライアントを使用して credentials.json を生成します。

設定

1. config/profiles.yaml で MCP サーバーを設定します
2. config/models.json でモデルの設定を行います
3. Google Cloud 認証情報を設定します：
   • credentials.json をルートディレクトリに配置します
   • アプリケーションを一度実行して token.json を生成します

🎮 使い方

エージェントの起動

uv run agent.py

Telegram ボットサーバーの起動

uv run telegram_sse_server.py

🛠️ MCP サーバー

MCP サーバー 1：基本操作

• 数学演算
• 画像処理
• ファイル操作

MCP サーバー 2：ドキュメント処理

• ドキュメントのインデックス作成
• セマンティック検索
• コンテンツ抽出
• 画像のキャプション生成

MCP サーバー 3：ウェブ連携

• DuckDuckGo 検索
• ウェブコンテンツの取得
• レート制限付きリクエスト

MCP サーバー 4：Google Workspace

• Gmail 連携
• Google Sheets 操作
• Google Drive 管理
• F1 順位表の取得（URL スクレイパー）

📡 通信

Telegram ボット

• コマンド処理
• メッセージ処理
• リアルタイム応答

SSE サーバー

• リアルタイムイベントストリーミング
• クライアント接続管理
• イベント配信

🧠 認知アーキテクチャ

エージェントは、以下のモジュールで構成される認知アーキテクチャを実装しています。

• 知覚：入力を処理し、関連情報を抽出します
• 記憶：状態と履歴データを管理します
• 意思決定：入力とコンテキストに基づいて戦略的な判断を行います
• 行動：適切なツールを通じて、決定したアクションを実行します

📝 ライセンス

MIT License