エージェントコンストラクト
「衣服から装備、武器、訓練シミュレーションまで、必要なものは何でも積載できます。」 - マトリックス（1999）
Agent Constructは、AIアプリケーションがツールやコンテキストにアクセスする方法を標準化する、モデルコンテキストプロトコル（MCP）サーバー実装です。映画『マトリックス』のコンストラクトがオペレーターに必要なあらゆる機器への即時アクセスを提供したように、Agent Constructは、MCP仕様を通じてAIモデルがツールやデータにアクセスするための標準化されたインターフェースを提供します。
モデルコンテキストプロトコル仕様に基づいて構築されており、AIアプリケーションのツール検出、実行、コンテキスト管理を管理する中央ハブとして機能します。標準化されたプロトコルを通じて、AIモデルに機能を公開するための堅牢かつスケーラブルな方法を提供します。また、簡素化された構成とツール構造により、新しい機能の追加も容易になります。GeminiでWebを検索するためのサンプルツールも含まれています。
コア機能
MCPプロトコルの実装
- 完全なMCP準拠：モデルコンテキストプロトコル仕様の完全な実装
- ツール検出: 動的なツール登録および検出メカニズム
- 標準化された通信: ツールの相互作用のためのMCPの通信パターンを実装します
サーバーアーキテクチャ
- FastAPIバックエンド：高性能な非同期サーバー実装
- イベントストリーミング: Server-Sent Events (SSE) によるリアルタイム更新
- モジュラー設計: コアプロトコル処理とツール実装を明確に分離
- ハンドラーシステム: さまざまなMCP操作に対応する拡張可能なリクエストハンドラーアーキテクチャ
- ツールベースのレート制限: ツールごとに設定可能なレート制限をサーバーが処理できるようにします。
開発機能
- ツールデコレータシステム: MCP 経由で新しいツールを公開する簡単な方法
- ログ記録と監視: デバッグと監視のための包括的なログ記録システム
- 構成管理: 安全なデフォルトを使用した環境ベースの構成
- テストフレームワーク: プロトコルコンプライアンスのための広範なテストスイート
- エージェント フレームワーク フレンドリー: カスタム クライアントまたは smolagents などのフレームワークの実装例が含まれています。
はじめる
前提条件
- Python 3.8以上
- pip パッケージマネージャー
インストール
- リポジトリをクローンします。
git clone https://github.com/yourusername/agent-construct.git
cd agent-construct
- 依存関係をインストールします:
pip install -r requirements.txt
- 環境変数を設定します。次の変数を含む
.envファイルをルート ディレクトリに作成します。# Server Configuration
SERVER_HOST=localhost
SERVER_PORT=8000
# MCP Protocol Settings
MCP_VERSION=1.0
TOOL_DISCOVERY_ENABLED=true
# Security Settings
ENABLE_AUTH=false # Enable for production
- サーバーを実行します。
コアアーキテクチャ
mcp_server/
├── core/ # Core MCP protocol implementation
│ ├── server.py # Main server implementation
│ ├── protocol.py # MCP protocol handlers
│ └── context.py # Context management
├── handlers/ # MCP operation handlers
│ ├── discovery.py # Tool discovery
│ ├── execution.py # Tool execution
│ └── context.py # Context operations
├── utils/ # Utility functions
│ ├── logging.py # Logging configuration
│ ├── security.py # Security utilities
│ └── config.py # Configuration management
└── __main__.py # Server entry point
MCPプロトコルの機能
ツールの発見
- 動的ツール登録システム
- ツール機能の広告
- バージョン管理
- ツールのメタデータとドキュメント
コンテキスト管理
- 効率的なコンテキストの保存と検索
- コンテキストのスコープと分離
- リアルタイムのコンテキスト更新
- コンテキスト永続化オプション
コミュニケーションパターン
- 同期リクエスト/レスポンス
- 更新に関するサーバー送信イベント
- ストリーミング応答
- エラー処理と回復
将来の機能強化
プロトコル拡張
- [ ] 高度なコンテキスト管理機能
- [ ] カスタムプロトコル拡張
- [ ] プロトコルハンドラーのプラグインシステム
安全
- [ ] 認証と認可
- [ ] ツールアクセス制御
- [-] レート制限とクォータ管理
- [ ] 監査ログ
- [ ] エンドツーエンドの暗号化
パフォーマンス
- [ ] ツール実行の最適化
- [ ] コンテキストキャッシュ
- [ ] 負荷分散
- [ ] リクエストキューイング
- [ ] リソース管理
発達
- [ ] インタラクティブプロトコルエクスプローラー
- [ ] ツール開発SDK
- [ ] プロトコルコンプライアンステストツール
- [ ] パフォーマンス監視ダッシュボード
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更については、まずIssueを開いて、変更したい点について議論してください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
謝辞
- プロトコル仕様のモデルコンテキストプロトコル
- 優れたウェブフレームワークのためのFastAPI
- このプロジェクトで使用されているさまざまなツールとライブラリのオープンソースコミュニティ