MCP Agent Graph (MAG)

English | 中文

Agent-Graph は、コンテキストエンジニアリングの原則に基づいて構築されたマルチエージェントシステムです。サブエージェント、長期記憶、MCP、エージェントベースのワークフローなどの機能を統合しています。コンテキストエンジニアリングのベストプラクティスをビジュアルな開発環境に取り入れることで、開発者は複雑なマルチエージェントアプリケーションを迅速に構築、テスト、デプロイできます。

ドキュメント	https://keta1930.github.io/agent-graph/

目次

1. フレームワーク
2. デプロイガイド
   • プロジェクトのクローン
   • Docker サービスの設定と起動
   • バックエンドのデプロイ
   • アプリケーションへのアクセス
3. 主な機能
4. 今後のロードマップ
   • 近日公開
   • 今後の予定
5. フロントエンド機能の紹介
6. 引用
7. WeChat グループ

1. フレームワーク

システムアーキテクチャ

ユーザージャーニー

2. デプロイガイド

📖 詳細なインストール手順：docs/first-steps/install.md

システム要件

コンポーネント	要件
オペレーティングシステム	Linux、macOS、または Windows（WSL2 が必要）
Docker	Docker Compose を含むバージョン 20.10 以降
Python	バージョン 3.11 以降
メモリ	最低 4GB（8GB 推奨）
ストレージ	10GB 以上の空き容量

クイックスタート

2.1. プロジェクトのクローン

git clone https://github.com/keta1930/agent-graph.git
cd agent-graph

2.2. Docker サービスの設定と起動

cp .env.example .env
# Set all blank credentials and secrets before startup
python agent_graph/scripts/generate_jwt_secret.py
docker compose --env-file .env -f docker/docker-compose.yml up -d

デフォルトのサービスアドレス：

• MongoDB Express（データベース管理）：http://localhost:20041
• MinIO Console（ファイルストレージ）：http://localhost:20043

2.3. バックエンドのデプロイ

uv を使用する場合（推奨）：

uv sync
uv run --env-file .env fastapi run

pip を使用する場合：

pip install -r requirements.txt
dotenv -f .env run -- fastapi run

バックグラウンドで実行：

nohup uv run --env-file .env fastapi run > app.log 2>&1 &

2.4. アプリケーションへのアクセス

PUBLIC_API_BASE_URL で設定したアドレスを開きます（デフォルト：**http://localhost:20050**）。

ログインページ（.env で設定したユーザー名とパスワードでの管理者ログイン）：

登録ページ（新規ユーザーは招待コードを使って登録できます）：

その他のアクセス先：

• API ドキュメント：http://localhost:20050/docs
• ヘルスチェック：http://localhost:20050/health

フロントエンド開発（任意）

フロントエンドのコードを変更する場合：

cd frontend
npm install
npm run dev  # Uses FRONTEND_PORT from the root .env
npm run build  # Build production version

**注：**リポジトリにはビルド済みのフロントエンドファイルが含まれています。この手順は、フロントエンドを開発またはカスタマイズする場合にのみ必要です。

3. 主な機能

コアコンポーネント

機能	説明	ドキュメント
エージェント	目標を理解し、ツールを使用し、最適化を繰り返し、コンテキストと長期記憶を保持する能力を備えた AI エンティティです。自律的なアクションの実行を通じて、自由度の高いタスクを解決します	エージェントのドキュメント
グラフ（ワークフロー）	複数のエージェントを構造化されたワークフローに編成し、ノードとエッジで実行フローを定義します。予測可能な複数段階のタスクに適しています	グラフのドキュメント
モデル	LLM および VLM モデル（OpenAI 互換）をサポートし、API キーを柔軟に設定できます	モデルのドキュメント
メモリ	短期記憶は会話のコンテキストを保持し、長期記憶はユーザー設定とセッションをまたいだエージェントのナレッジベースを保存します	メモリのドキュメント
プロンプトセンター	再利用可能なプロンプトテンプレートを一元管理します。分類、インポート／エクスポート、プロジェクト間の参照に対応しています	プロンプトのドキュメント
プロジェクト	共有ファイルを含むコレクションに会話を整理します	プロジェクトのドキュメント

ワークフロー機能

機能	説明	ドキュメント
ビジュアルグラフエディター	フロントエンドでのドラッグ＆ドロップによるワークフロー設計に対応し、直線型、並列型、条件型、ネスト型のグラフをサポートします。WYSIWYG 形式です	グラフのドキュメント
サブグラフのネスト	グラフ全体を単一のノードとしてネストでき、モジュール化され、再利用可能で階層的なワークフローを構築できます	サブグラフのドキュメント
ハンドオフ（スマートルーティング）	ノードが次に実行するノードを動的に選択します。インテリジェントな判断、条件分岐、反復最適化ループに対応しています	ハンドオフのドキュメント
タスク（スケジューリング）	グラフをスケジュールに従って、または定期的に自動実行します。cron 式、同時実行インスタンス、実行履歴の追跡に対応しています	タスクのドキュメント

拡張機能

機能	説明	ドキュメント
MCP プロトコル統合	標準化されたプロトコルを通じて、外部ツールやデータソース（データベース、API、ファイルシステム、クラウドサービスなど）に接続します。一度接続すれば、どこからでも利用できます	MCP のドキュメント
組み込みツールセット	リソース作成（Agent Creator、Graph Designer、MCP Builder、Prompt Generator、Task Manager）、コラボレーション（Sub-agent、File Tool）、クエリ（Memory Tool、System Operations）のためのシステムツールを提供します	ツールのドキュメント

コラボレーションと管理

機能	説明	ドキュメント
チームコラボレーション	管理者は招待コードを作成し、チームメンバーを管理して、ロールの権限（Super Admin、Admin、Regular User）を割り当てられます	チーム管理
会話管理	会話履歴の表示、添付ファイルの管理、セッションコンテキストの維持に対応しています	クイックスタート

4. 今後のロードマップ

📖 ロードマップの全容： docs/roadmap/index.md

このプラットフォームは進化を続け、より強力なエージェント機能と、より優れたコラボレーション体験をユーザーに提供します。

最近実装された機能

以下の機能が最近実装され、利用できるようになりました。

機能	主な価値	ドキュメント
マルチモーダル対応	VLM によってエージェントが視覚的な理解能力を得られます	詳細
プロジェクト	会話を共有リソース付きのコレクションに整理できます	詳細

近日公開予定

以下の機能は近日公開予定、または現在開発中です。

機能	主な価値	ドキュメント
チームでのリソース共有	チーム内でエージェント、ワークフロー、プロンプトを共有できます	詳細
エージェントスキル	効率と機能を向上させる段階的なコンテキストエンジニアリング	詳細

今後の計画

以下の機能は、継続的に検討・計画しています。

機能	主な価値	ドキュメント
外部エージェント API	エージェントへの外部からの呼び出しを可能にし、サービスエコシステムを構築します	詳細
ユーザー分析	効果の評価とチームの状況把握	詳細

5. フロントエンド機能の紹介

5.1. チャットのウェルカムページ

エージェントとの会話を始めるための画面です。プリセットされたエージェントをすばやく選択したり、新しい会話を作成したりできます。

---

5.2. ワークスペース - エージェント管理

エージェントを作成、設定、管理し、システムプロンプト、ツール、モデルパラメーターを設定できます。

---

5.3. ワークスペース - ワークフロー管理

ビジュアルなドラッグ＆ドロップ式のワークフロー設計ツールです。複数のノードタイプと複雑なプロセスのオーケストレーションに対応しています。

---

5.4. ワークスペース - モデル管理

複数の LLM モデルを設定・管理し、API Keys とモデルパラメーターを設定できます。

---

5.5. ワークスペース - システムツールボックス

リソース作成ツールやコラボレーションツールなど、組み込みのシステムツールを表示・設定できます。

---

5.6. ワークスペース - MCP 管理

MCP サーバーへの接続を管理し、外部ツールやデータソースとの統合を設定できます。

---

5.7. ワークスペース - プロンプト管理

再利用可能なプロンプトテンプレートを一元管理できます。分類とバージョン管理に対応しています。

---

5.8. ワークスペース - ファイル管理

アップロードしたファイルや添付ファイルを管理できます。ファイルのプレビューと整理に対応しています。

---

5.9. ワークスペース - メモリ管理

エージェントの長期メモリとナレッジベースを表示・管理できます。

---

6. 引用

Agent-Graph が研究や業務に役立つと感じた場合は、引用をご検討ください。

@misc{agent_graph_2025,
  title        = {agent-graph},
  author       = {Yan Yixin},
  howpublished = {\url{https://github.com/keta1930/agent-graph}},
  note         = {Accessed: 2025-04-24},
  year         = {2025}
}

7. お問い合わせ

ご質問、ご提案、共同作業に関するお問い合わせは、お気軽にご連絡ください。

📧 メール：[email protected]