From 128e0882435df173400b25d84f9f510e14cad88f Mon Sep 17 00:00:00 2001 From: naizo01 Date: Sun, 21 Dec 2025 14:34:28 +0900 Subject: [PATCH] Add file creation commands for new directories in sections 2, 3, 4, and 5 of the JPYC ChatApp documentation. Updated instructions to reflect the correct project structure and added environment variable setup for the MCP server. --- .../section-2/lesson-1.md | 29 +++++++++++++++++-- .../section-3/lesson-1.md | 1 + .../section-3/lesson-2.md | 1 + .../section-3/lesson-3.md | 1 + .../section-4/lesson-1.md | 1 + .../section-4/lesson-2.md | 1 + .../section-4/lesson-3.md | 1 + .../section-5/lesson-1.md | 1 + .../section-5/lesson-3.md | 1 + 9 files changed, 35 insertions(+), 2 deletions(-) diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-2/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-2/lesson-1.md index 4aa975de..b7dc814c 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-2/lesson-1.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-2/lesson-1.md @@ -18,11 +18,15 @@ title: プロジェクトのセットアップ まず、スターターリポジトリをクローンしてきます。 +スターターリポジトリは以下のリンクからアクセスできます： + +**https://github.com/unchain-tech/jpyc-ai-agent** + **自分のGitHubアカウントにフォークしていない場合は、まずフォークしてきましょう！** ```bash git clone https://github.com//jpyc-ai-agent -cd ai-agent-jpyc-chat +cd jpyc-ai-agent ``` ### 📦 依存関係のインストールとコンパイル @@ -41,7 +45,7 @@ pnpm run compile ### 📁 プロジェクト構造の作成 -`ai-agent-jpyc-chat`以下のディレクトリ構造が以下のようになっているかを確認します。 +`jpyc-ai-agent`以下のディレクトリ構造が以下のようになっているかを確認します。 ``` ai-agent-jpyc-chat/ @@ -106,8 +110,29 @@ ANTHROPIC_API_KEY= JPYC_MCP_SERVER_URL="http://localhost:3001/sse" ``` +次に、MCPサーバー用の環境変数ファイルも作成します。MCPサーバーは**独立したプロセス**として動作するため、`external/mcp`ディレクトリに`.env`ファイルを作成する必要があります。 + +```bash +# external/mcpディレクトリに移動 +cd external/mcp + +# .env.exampleをコピーして.envを作成（.env.exampleが存在する場合） +# 存在しない場合は直接.envファイルを作成してください +cp .env.example .env +touch .env +``` + +`external/mcp/.env`ファイルに環境変数を設定します： + +```.env +# MCPサーバー用の環境変数 +PRIVATE_KEY=0x... # ウォレットの秘密鍵（.env.localと同じ値を使用） +``` + **重要**： - `.env.local`は`.gitignore`に含まれていることを確認してください +- `external/mcp/.env`も`.gitignore`に含まれていることを確認してください +- ルートディレクトリの`.env.local`とは別に、`external/mcp/.env`も必要です - 本番環境では、秘密鍵を環境変数として安全に管理してください ### 🙋‍♂️ 質問する diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-1.md index ed90ef81..e67e6c17 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-1.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-1.md @@ -17,6 +17,7 @@ title: JPYC SDK Wrapperの実装 ```bash cd jpyc-ai-agent +mkdir -p external/mcp/src/jpyc touch external/mcp/src/jpyc/sdk.ts ``` diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-2.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-2.md index ad6012fe..532d6dae 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-2.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-2.md @@ -17,6 +17,7 @@ MCPツールは、AI Agentが実行できる「関数」として機能します ```bash cd jpyc-ai-agent +mkdir -p external/mcp/src touch external/mcp/src/tools.ts ``` 以下のコードを記述します： diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-3.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-3.md index e1c1d49c..bb448df4 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-3.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-3/lesson-3.md @@ -17,6 +17,7 @@ MCPサーバーは、HTTP/SSE（Server-Sent Events）プロトコルを使用し ```bash cd jpyc-ai-agent +mkdir -p external/mcp/src touch external/mcp/src/index.ts ``` diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-1.md index 688a88bf..3fe6aff1 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-1.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-1.md @@ -19,6 +19,7 @@ title: LLMモデルの設定 ```bash cd jpyc-ai-agent +mkdir -p src/lib/mastra/model touch src/lib/mastra/model/index.ts ``` diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-2.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-2.md index e3aa30fa..152af78e 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-2.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-2.md @@ -17,6 +17,7 @@ MCPクライアントは、AI AgentからMCPサーバーに接続し、ツール ```bash cd jpyc-ai-agent +mkdir -p src/lib/mastra/mcp touch src/lib/mastra/mcp/client.ts ``` diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-3.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-3.md index 45033d5b..a89ea793 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-3.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-4/lesson-3.md @@ -17,6 +17,7 @@ AI Agentは、ユーザーの自然言語の指示を理解し、適切なMCPツ ```bash cd jpyc-ai-agent +mkdir -p src/lib/mastra touch src/lib/mastra/agent.ts ``` diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-1.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-1.md index 60a8ee0a..1ab1f917 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-1.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-1.md @@ -17,6 +17,7 @@ title: チャットAPIの実装 ```bash cd jpyc-ai-agent +mkdir -p src/app/api/chat touch src/app/api/chat/route.ts ``` diff --git a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-3.md b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-3.md index 626fcd09..6d270474 100644 --- a/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-3.md +++ b/docs/JPYC/AI-Agent-JPYC-ChatApp/section-5/lesson-3.md @@ -18,6 +18,7 @@ title: チャットインターフェース（前半） ```bash cd jpyc-ai-agent +mkdir -p src/components touch src/components/ChatInterface.tsx ```