Langgraph MCP Agent

🚀 ストーリーIPクリエイターエージェント

LangGraphをベースにしたエージェントで、Story上でIP資産の作成、鋳造、登録を行います。

このエージェントは、ユーザーがAI画像を生成し、それをIPFSにアップロードし、Storyブロックチェーン上でIP資産として登録するのを支援します。具体的な流れは以下の通りです。

1. DALL-E 3を使用して画像を生成する。
2. 生成された画像に対するユーザーの承認を得る。
3. 承認された画像をIPFSにアップロードする。
4. IPメタデータを作成する。
5. ユーザーとライセンス条項を交渉する。
6. Story上でIPを鋳造し、登録する。
7. IPのライセンストークンを鋳造する。

✨ 主な機能

このエージェントは、DALL-E 3を使った画像生成、IPFSへの画像アップロード、Storyブロックチェーン上でのIP資産の鋳造と登録など、一連のIP資産作成プロセスを自動化します。ユーザーは画像の説明を入力するだけで、残りの作業をエージェントが処理します。

📦 インストール

必要な環境

• Python 3.9+
• LangGraph
• LangChain
• OpenAI APIキー（DALL-EとGPTモデル用）
• Story SDK

ディレクトリ構造

このエージェントを正常に動作させるには、特定のディレクトリ構造が必要です。

your-root-directory/
├── langgraph-mcp-agent/
│   ├── agent.py
│   └── ...
├── story-mcp-hub/          
│   ├── story-sdk-mcp/
│   │   ├── server.py
│   │   └── ...
│   └── ...

インストール手順

1. uvをインストールします。

curl -LsSf https://astral.sh/uv/install.sh | sh

2. このリポジトリをクローンし、プロジェクトディレクトリに移動します。
3. uvを使って依存関係をインストールします。

uv sync

4. 環境変数を設定します。

cp .env.example .env

その後、.envファイルを編集し、あなたのAPIキーと設定ですべての変数を置き換えます。 5. story-sdk-mcp リポジトリを このリポジトリをクローンしたのと同じフォルダに クローンします。上記の ディレクトリ構造 のセクションに示されているように配置します。READMEの説明に従って、このMCPサーバーを設定してインストールし、 すべての .env変数を設定してください。このサーバーを実行する必要はありません。このエージェントがアクセスできるように同じフォルダに配置するだけです。

💻 使用例

基本的な使用法

エージェントを実行するには、以下のコマンドを実行します。

uv run agent.py

エージェントは、以下のような対話型のプロセスを通じてあなたを案内します。

1. 画像の説明を入力します（例：「アニメスタイルの人物がスキーをする」）。
2. 生成された画像を確認し、承認するか新しい画像を要求します。
3. ライセンス条項を設定します。
   • 商業収入の分配率（0 - 100%）
   • 二次創作の許可（はい/いいえ）
4. Storyブロックチェーン上での鋳造プロセスを完了します。

サンプルのワークフロー

agent.pyを実行すると、以下のようなワークフローを経験できます。

=== ストーリーIPクリエイター ===
このツールは、ストーリーエコシステム内で画像をIP資産として作成および鋳造するのを支援します。

どのような画像を作成したいですか？（例：「アニメスタイルの人物がスキーをする」）： blob が山頂でスケートボードをする

作成プロセスを開始します...

[画像を生成し、リンクを提供]

この画像は好きですか？（はい/いいえ + フィードバック）： はい
画像をIPFSにアップロードしています...

[メタデータを生成]

商業収入の分配率を入力してください（0 - 100%、デフォルト値：15%）： 20
二次創作を許可しますか？（はい/いいえ、デフォルト値：はい）： はい

[鋳造と登録プロセス]

=== プロセス完了 ===
あなたのIPが正常に作成され、ストーリーに登録されました！

このエージェントは、画像生成のためのDALL-E、ストレージのためのIPFS、およびStoryブロックチェーン上での鋳造と登録に関するすべての複雑なやり取りを処理します。