From 8483e5c28748a15ae6cb6b48e9d7f2535e4cdde9 Mon Sep 17 00:00:00 2001 From: ienaga Date: Thu, 26 Feb 2026 15:26:15 +0900 Subject: [PATCH 1/5] update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bc4f1d3..c0d9eb3 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # next2d-development-mcp
- Next2D + Next2D
[![UnitTest](https://github.com/Next2D/next2d-development-mcp/actions/workflows/integration.yml/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/integration.yml) From 13a6c76e509dc29aa659b2b83d2aa7bd0435caaa Mon Sep 17 00:00:00 2001 From: ienaga Date: Thu, 26 Feb 2026 15:27:15 +0900 Subject: [PATCH 2/5] update README.md --- README.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/README.md b/README.md index c0d9eb3..a8cdeac 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,5 @@ # next2d-development-mcp -
- Next2D -
- [![UnitTest](https://github.com/Next2D/next2d-development-mcp/actions/workflows/integration.yml/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/integration.yml) [![CodeQL](https://github.com/Next2D/next2d-development-mcp/actions/workflows/github-code-scanning/codeql/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/github-code-scanning/codeql) [![Lint](https://github.com/Next2D/next2d-development-mcp/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/Next2D/next2d-development-mcp/actions/workflows/lint.yml) From 2aff2fe110483a43a378a445816d112f5580ccb2 Mon Sep 17 00:00:00 2001 From: ienaga Date: Thu, 26 Feb 2026 16:02:08 +0900 Subject: [PATCH 3/5] =?UTF-8?q?=E8=BF=BD=E5=8A=A0=E6=A9=9F=E8=83=BD?= =?UTF-8?q?=E5=88=86=E3=81=AE=E6=83=85=E5=A0=B1=E3=82=92README=E3=81=AB?= =?UTF-8?q?=E8=BF=BD=E8=A8=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 48 +++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 45 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a8cdeac..1303f2a 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,7 @@ Provides code generation, architecture validation, and API reference following * - [Resources / リソース](#resources--リソース) - [Prompts / プロンプト](#prompts--プロンプト) - [サポートするアーキテクチャ / Supported Architecture](#サポートするアーキテクチャ--supported-architecture) +- [関連リンク / Related Links](#関連リンク--related-links) - [License](#license) --- @@ -39,11 +40,15 @@ This MCP server provides the following capabilities to AI agents: | 機能 / Feature | 説明 / Description | |---|---| -| **コード生成** | View/ViewModel, UseCase, Repository, UI コンポーネント, Interface のスキャフォールディング | +| **コード生成** | View/ViewModel, UseCase, Repository, UI コンポーネント, Interface, Animation, Domain Service のスキャフォールディング | | **ルーティング設定** | routing.json へのルートエントリ生成 | | **アーキテクチャ検証** | プロジェクト構造の Clean Architecture 準拠チェック | +| **プロジェクト分析** | 実装済みファイルのスキャンと未実装箇所のレポート | +| **画面インスペクション** | 特定画面の全関連ファイルの一覧と実装状況の確認 | +| **実装計画生成** | 既存ファイルをスキップしつつ新規画面の順序付き実装ステップを生成 | | **API リファレンス** | Player API, Framework 仕様, 開発テンプレート仕様の提供 | | **開発ガイド** | 画面追加手順, コーディング規約, デバッグガイドの提供 | +| **オーケストレーター** | 新規画面作成・既存画面修正をフェーズ別に自律実行 | --- @@ -252,14 +257,32 @@ args: -y next2d-development-mcp ## Tools / ツール +### オーケストレーション系 / Orchestration + +| Tool | Description | +|---|---| +| `analyze_project` | routing.json をスキャンし、View/ViewModel/UseCase/Repository の実装状況を一覧表示。新機能追加前の現状把握に使用 | +| `inspect_screen` | 特定画面の全関連ファイル (View, ViewModel, Page, UseCase, Repository, Animation, Content) をファイル行数付きで一覧表示。既存画面修正前に使用 | +| `plan_feature` | 新規画面の実装ステップを順序付きで生成。既存ファイルは ✅ としてスキップ。`analyze_project` 実行後に使用 | + +### コード生成系 / Code Generation + | Tool | Description | |---|---| | `create_view` | View/ViewModel ペアを生成 (MVVM パターン)。`name` にルートパスを指定 (例: `home`, `quest/list`) | | `create_usecase` | UseCase クラスを生成 (Application 層)。1 アクション = 1 UseCase、`execute()` がエントリーポイント | | `create_repository` | Repository クラスを生成 (Infrastructure 層)。try-catch 必須、config からエンドポイント取得 | | `create_ui_component` | Atomic Design UI コンポーネント生成 (`atom` / `molecule` / `organism` / `page` / `content`) | +| `create_animation` | UI トランジション用 Animation クラスを生成。`@next2d/ui` の Tween/Easing/Job を使用。`src/ui/animation/{screen}/` に配置 | +| `create_domain_service` | Domain 層クラス (Service または Callback) を生成。Service はコアビジネスロジック、Callback は gotoView 完了後に実行 | +| `create_loading` | ローディング画面クラスを生成。`start()` / `end()` メソッドを持ち、config.json の `loading.callback` で登録 | | `add_route` | routing.json へのルートエントリ生成。リクエスト設定 (`json` / `content` / `custom` / `cluster`) に対応 | | `create_interface` | TypeScript インターフェースファイル生成 (`I` プレフィックス規約に準拠) | + +### アーキテクチャ検証 / Architecture Validation + +| Tool | Description | +|---|---| | `validate_architecture` | プロジェクト構造の検証。ディレクトリ構成、設定ファイル、routing.json ↔ View の整合性をチェック | ### ツール使用例 / Tool Usage Example @@ -271,7 +294,7 @@ Next2Dプロジェクトに「quest/list」画面を追加して。 APIからクエスト一覧を取得して表示するようにして。 ``` -エージェントが自動的に `add_route` → `create_view` → `create_usecase` → `create_repository` → `create_interface` → `create_ui_component` を順に実行し、必要なファイルをすべて生成します。 +オーケストレーターモードでは `analyze_project` → `plan_feature` → `add_route` → `create_view` → `create_usecase` → `create_repository` → `create_interface` → `create_ui_component` → `create_animation` → `validate_architecture` を自律的に実行し、必要なファイルをすべて生成します。 --- @@ -290,10 +313,24 @@ APIからクエスト一覧を取得して表示するようにして。 | Prompt | Parameters | Description | |---|---|---| +| `orchestrate` | `task`, `screenPath`, `mode` | オーケストレーターモードを起動。`mode: "create"` で新規画面作成、`mode: "modify"` で既存画面修正のフェーズ別ワークフローを実行 | | `new-screen` | `screenName`, `hasApi?`, `hasAnimation?` | 新しい画面追加のステップバイステップガイド | | `architecture-guide` | — | アーキテクチャルールとコーディング規約のリファレンス | | `debug-help` | `issue` | よくある問題のデバッグのヒントとトラブルシューティング | +### orchestrate プロンプトの使用例 / Orchestrate Prompt Example + +``` +# 新規画面作成 +orchestrate(task="クエスト一覧画面を追加", screenPath="quest/list", mode="create") + +# 既存画面修正 +orchestrate(task="ホーム画面に検索機能を追加", screenPath="home", mode="modify") +``` + +`create` モードでは `analyze_project` → `plan_feature` → 実装 → `validate_architecture` の順に実行します。 +`modify` モードでは `inspect_screen` → 対象ファイル Read → 最小変更 → `validate_architecture` の順に実行します。 + --- ## サポートするアーキテクチャ / Supported Architecture @@ -304,9 +341,14 @@ src/ ├── interface/ # インターフェース定義 (I プレフィックス) ├── model/ │ ├── application/ # UseCase (ビジネスロジック) -│ ├── domain/ # コアビジネスルール +│ ├── domain/ +│ │ └── callback/ # gotoView Callback / Loading クラス +│ │ └── {name}/ +│ │ └── service/ # Domain Service (純粋ビジネスロジック) │ └── infrastructure/ # Repository (データアクセス) ├── ui/ +│ ├── animation/ # UI トランジション Animation クラス +│ │ └── {screen}/ # 画面別ディレクトリ │ ├── component/ │ │ ├── atom/ # 最小コンポーネント │ │ ├── molecule/ # 複合コンポーネント From 36342a23e10c73871643cc937d7a1f470002e3de Mon Sep 17 00:00:00 2001 From: ienaga Date: Thu, 26 Feb 2026 22:24:19 +0900 Subject: [PATCH 4/5] =?UTF-8?q?=E6=9C=80=E6=96=B0=E7=89=88=E3=81=AE?= =?UTF-8?q?=E3=82=B9=E3=82=AD=E3=83=AB=E3=81=AE=E5=8F=96=E3=82=8A=E8=BE=BC?= =?UTF-8?q?=E3=81=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- next2d-development-assistant | 2 +- package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/next2d-development-assistant b/next2d-development-assistant index c7d6966..9234ff9 160000 --- a/next2d-development-assistant +++ b/next2d-development-assistant @@ -1 +1 @@ -Subproject commit c7d6966723c143c797a2395cde364bde5d378937 +Subproject commit 9234ff981681af046caceb24725d7c28de47f339 diff --git a/package-lock.json b/package-lock.json index 5768eed..29a6f7b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "next2d-development-mcp", - "version": "1.1.0", + "version": "1.1.1", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "next2d-development-mcp", - "version": "1.1.0", + "version": "1.1.1", "license": "MIT", "dependencies": { "@modelcontextprotocol/sdk": "^1.27.1" diff --git a/package.json b/package.json index 81857db..817ab43 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "next2d-development-mcp", "displayName": "Next2D Development MCP", - "version": "1.1.0", + "version": "1.1.1", "description": "MCP server for Next2D application development assistance", "type": "module", "author": "Toshiyuki Ienaga ", From d164510b64ea4028a904ed77f06601530f2d510b Mon Sep 17 00:00:00 2001 From: ienaga Date: Thu, 26 Feb 2026 22:32:55 +0900 Subject: [PATCH 5/5] =?UTF-8?q?=E6=9C=80=E6=96=B0=E7=89=88=E3=81=AE?= =?UTF-8?q?=E3=82=B9=E3=82=AD=E3=83=AB=E3=81=AE=E5=8F=96=E3=82=8A=E8=BE=BC?= =?UTF-8?q?=E3=81=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- next2d-development-assistant | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/next2d-development-assistant b/next2d-development-assistant index 9234ff9..1ffeb8d 160000 --- a/next2d-development-assistant +++ b/next2d-development-assistant @@ -1 +1 @@ -Subproject commit 9234ff981681af046caceb24725d7c28de47f339 +Subproject commit 1ffeb8dde506bccc253e8c4dbb70b04978b0e4d6