Agent Construct

🚀 Agent Construct

Agent Constructは、AIアプリケーションがツールやコンテキストにアクセスする方法を標準化するModel Context Protocol (MCP) サーバーの実装です。映画『マトリックス』のコンストラクトがオペレーターに必要な装備を即座に提供するのと同じように、Agent ConstructはAIモデルにMCP規格を通じてツールやサービスデータに標準化されたアクセスを提供します。

"私たちは何でもロードできます。服装から装置、武器、訓練シミュレーションまで、必要なものなら何でも。" ——『マトリックス』(1999)

🚀 クイックスタート

Agent Constructは、Model Context Protocol 規格に基づいて構築された中央的なハブとして機能し、ツールの検出、実行、コンテキスト管理を行います。これにより、AIアプリケーションはMCP規格を通じてモデルに機能を公開する強力で拡張性の高い方法を得ることができます。また、簡素化された設定とツール構造を提供し、新機能の追加を容易にします。Geminiを使用したウェブ検索のサンプルツールも含まれています。

✨ 主な機能

MCP プロトコルの実装

• 完全なMCP互換性：Model Context Protocol規格を完全に実装しています。
• ツールの検出：動的なツール登録と検出メカニズムがあります。
• 標準化された通信：MCPの通信モードを実装してツールとのやり取りを行います。

サーバーアーキテクチャ

• FastAPIバックエンド：高性能の非同期サーバー実装です。
• イベントのストリーミング：Server-Sent Events (SSE) を通じてリアルタイム更新を提供します。
• モジュール化設計：コアプロトコル処理とツール実装が明確に分離されています。
• プロセッサシステム：異なるMCP操作をサポートするための拡張可能なリクエストプロセッサアーキテクチャがあります。
• ツールベースのレート制限：サーバーが設定式のツールレート制限を処理できます。

開発機能

• ツールデコレータシステム：MCPを通じて新しいツールを簡単に公開する方法です。
• ロギングと監視：デバッグと監視のための包括的なロギングシステムがあります。
• 設定管理：環境に基づく設定で、安全なデフォルト値があります。
• テストフレームワーク：プロトコルの準拠を確保するための包括的なテストスイートがあります。
• 使いやすいエージェントフレームワーク：カスタムクライアントやsmolagentsなどのフレームワークの実装例が含まれています。

📦 インストール

前提条件

• Python 3.8以上
• pipパッケージマネージャー

手順

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

   git clone https://github.com/yourusername/agent-construct.git
   cd agent-construct
   

2. 依存関係をインストールします:

   pip install -r requirements.txt
   

3. 環境変数を設定します: ルートディレクトリに .env ファイルを作成し、以下の変数を含めます。

   # サーバー設定
   SERVER_HOST=localhost
   SERVER_PORT=8000
   
   # MCP プロトコル設定
   MCP_VERSION=1.0
   TOOL_DISCOVERY_ENABLED=true
   
   # セキュリティ設定
   ENABLE_AUTH=false  # 本番環境では有効にする
   

4. サーバーを起動します:

   python -m mcp_server
   

🔧 技術詳細

コアアーキテクチャ

mcp_server/
├── core/               # コアMCPプロトコルの実装
│   ├── server.py      # メインサーバーの実装
│   ├── protocol.py    # MCPプロトコルの処理
│   └── context.py     # コンテキスト管理
├── handlers/          # MCP操作のハンドラー
│   ├── discovery.py   # ツールの検出
│   ├── execution.py   # ツールの実行
│   └── context.py     # コンテキスト操作
├── utils/            # ユーティリティ関数
│   ├── logging.py    # ロギング設定
│   ├── security.py   # セキュリティツール
│   └── config.py     # 設定管理
└── __main__.py       # サーバーのエントリーポイント

MCP プロトコルの機能

ツールの検出

• 動的なツール登録システム
• ツールの機能広告
• バージョン管理
• ツールのメタデータとドキュメント

コンテキスト管理

• 効率的なコンテキストの保存と検索
• コンテキストのロード/アンロード
• コンテキストの共有と分離

その他の機能

• セキュリティ：設定により異なるモデル間のリソース分離を実現し、各モデルが許可されたツールとサービスのみにアクセスできるようにします。
• 拡張性：新しいコンテキストとツールの追加をサポートし、異なるモデルのニーズに対応します。

📄 ライセンス

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

謝辞

• Model Context Protocol がプロトコル規格を提供しています。
• FastAPIが優れたウェブフレームワークを提供しています。
• このプロジェクトを構築するために使用されたオープンソースコミュニティの様々なツールとライブラリに感謝します。