next2d-development-mcp

Next2D アプリケーション開発を支援する MCP (Model Context Protocol) サーバーです。
framework-typescript-template を使った MVVM + Clean Architecture + Atomic Design パターンに従ったコード生成、アーキテクチャ検証、API リファレンスを提供します。

An MCP (Model Context Protocol) server for Next2D application development.
Provides code generation, architecture validation, and API reference following MVVM + Clean Architecture + Atomic Design patterns used with the framework-typescript-template.

---

目次 / Table of Contents

• 概要 / Overview
• 必要な環境 / Requirements
• AI エージェントへの追加方法 / AI Agent Setup
• Tools / ツール
• Resources / リソース
• Prompts / プロンプト
• サポートするアーキテクチャ / Supported Architecture
• 関連リンク / Related Links
• License

---

概要 / Overview

Next2D は WebGL/WebGPU ベースの 2D レンダリングエンジン (Player) と MVVM フレームワーク (Framework) で構成される、マルチプラットフォーム対応の開発環境です。

Next2D is a multi-platform development environment consisting of a WebGL/WebGPU based 2D rendering engine (Player) and an MVVM framework (Framework).

この MCP サーバーは以下の機能を AI エージェントに提供します:

This MCP server provides the following capabilities to AI agents:

機能 / Feature	説明 / Description
コード生成	View/ViewModel, UseCase, Repository, UI コンポーネント, Interface, Animation, Domain Service のスキャフォールディング
ルーティング設定	routing.json へのルートエントリ生成
アーキテクチャ検証	プロジェクト構造の Clean Architecture 準拠チェック
プロジェクト分析	実装済みファイルのスキャンと未実装箇所のレポート
画面インスペクション	特定画面の全関連ファイルの一覧と実装状況の確認
実装計画生成	既存ファイルをスキップしつつ新規画面の順序付き実装ステップを生成
API リファレンス	Player API, Framework 仕様, 開発テンプレート仕様の提供
開発ガイド	画面追加手順, コーディング規約, デバッグガイドの提供
オーケストレーター	新規画面作成・既存画面修正をフェーズ別に自律実行

---

必要な環境 / Requirements

ツール / Tool	バージョン / Version
Node.js	22.x 以上 / 22.x or higher
npm	10.x 以上 / 10.x or higher

---

AI エージェントへの追加方法 / AI Agent Setup

VS Code Marketplace（推奨 / Recommended）

VS Code Marketplace からワンクリックでインストールできます。 Install with one click from the VS Code Marketplace:

インストール後、GitHub Copilot Chat で @next2d を入力すると MCP ツールが利用可能になります。 After installation, MCP tools are available by typing @next2d in GitHub Copilot Chat.

---

GitHub Copilot (VS Code / VS Code Insiders)

プロジェクトルートに .vscode/mcp.json を作成します。
Create .vscode/mcp.json at the project root:

{
  "servers": {
    "next2d": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

VS Code の設定 (settings.json) で MCP を有効化:
Enable MCP in VS Code settings (settings.json):

{
  "github.copilot.chat.mcp.enabled": true
}

💡 Copilot Chat で @mcp を入力すると、利用可能なツールが表示されます。
💡 Type @mcp in Copilot Chat to see available tools.

Claude Desktop

設定ファイルを編集します。
Edit the configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

💡 設定後、Claude Desktop を再起動してください。
💡 Restart Claude Desktop after updating the configuration.

Claude Code (CLI)

プロジェクトルートに .mcp.json を作成します。
Create .mcp.json at the project root:

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

または、CLI で直接追加:
Or add directly via CLI:

claude mcp add next2d -- npx -y next2d-development-mcp

OpenAI Codex (ChatGPT CLI)

プロジェクトルートに .codex/mcp.json を作成します。
Create .codex/mcp.json at the project root:

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

npm キャッシュ権限エラー (EPERM, ~/.npm/_npx) が出る場合はキャッシュ先を明示してください。
If npm cache permission errors occur, set a writable cache path: "args": ["-y", "--cache", "/tmp/next2d-mcp-npm-cache", "next2d-development-mcp"]

Gemini CLI

プロジェクトルートに .gemini/settings.json を作成します。
Create .gemini/settings.json at the project root:

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

Cline (VS Code Extension)

Cline の設定画面から MCP サーバーを追加します。
Add the MCP server from Cline settings:

1. VS Code で Cline 拡張のサイドバーを開く / Open the Cline extension sidebar in VS Code
2. MCP Servers セクションを開く / Open the MCP Servers section
3. Edit MCP Settings をクリック / Click Edit MCP Settings
4. 以下を追加 / Add the following:

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

Cursor

Cursor の設定ファイルに追加します。
Add to Cursor settings:

• プロジェクト単位 / Per-project: .cursor/mcp.json
• グローバル / Global: ~/.cursor/mcp.json

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

Windsurf

Windsurf の MCP 設定ファイルに追加します。
Add to Windsurf MCP configuration:

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "next2d-development-mcp": {
      "command": "npx",
      "args": ["-y", "next2d-development-mcp"]
    }
  }
}

その他の MCP 対応クライアント / Other MCP-compatible Clients

MCP は stdio トランスポートの標準プロトコルです。MCP 対応の任意のクライアントで以下のコマンドを設定すれば利用可能です:

MCP uses the standard stdio transport protocol. Configure the following command in any MCP-compatible client:

command: npx
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

AI エージェントへの指示例:

Next2Dプロジェクトに「quest/list」画面を追加して。
APIからクエスト一覧を取得して表示するようにして。

オーケストレーターモードでは analyze_project → plan_feature → add_route → create_view → create_usecase → create_repository → create_interface → create_ui_component → create_animation → validate_architecture を自律的に実行し、必要なファイルをすべて生成します。

---

Resources / リソース

Resource	URI	Description
Player API Specs	next2d://specs/player	DisplayObject, MovieClip, Sprite, Shape, TextField, Video, Sound, Tween, Events, Filters 等の API リファレンス
Framework Specs	next2d://specs/framework	MVVM アーキテクチャ, ルーティング, config 設定, View/ViewModel ライフサイクル, gotoView フロー
Development Specs	next2d://specs/develop	プロジェクト構造, CLI コマンド, Interface 定義, Model 層, UI 層 (Atomic Design), View/ViewModel パターン
Architecture Overview	next2d://architecture	アーキテクチャ概要, レイヤー構成, 設定ファイル仕様, ライフサイクル, npm コマンド一覧

---

Prompts / プロンプト

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

src/
├── config/                    # 設定ファイル (stage.json, config.json, routing.json)
├── interface/                 # インターフェース定義 (I プレフィックス)
├── model/
│   ├── application/           # UseCase (ビジネスロジック)
│   ├── domain/
│   │   └── callback/          # gotoView Callback / Loading クラス
│   │       └── {name}/
│   │           └── service/   # Domain Service (純粋ビジネスロジック)
│   └── infrastructure/        # Repository (データアクセス)
├── ui/
│   ├── animation/             # UI トランジション Animation クラス
│   │   └── {screen}/          # 画面別ディレクトリ
│   ├── component/
│   │   ├── atom/              # 最小コンポーネント
│   │   ├── molecule/          # 複合コンポーネント
│   │   ├── organism/          # 複雑なコンポーネント
│   │   └── page/              # 画面レイアウト
│   └── content/               # Animation Tool コンテンツ
└── view/                      # View & ViewModel (MVVM)

レイヤー依存関係 / Layer Dependencies

View Layer (view/, ui/)
  └─ depends on ─→ Interface Layer (interface/)
                     ↑
Application Layer (model/application/)
  ├─ depends on ─→ Interface Layer
  ├─ depends on ─→ Domain Layer (model/domain/)
  └─ calls ──────→ Infrastructure Layer (model/infrastructure/)

View ライフサイクル / View Lifecycle

ViewModel.constructor
  → ViewModel.initialize()
    → View.constructor(vm)
      → View.initialize()
        → View.onEnter()
          → (ユーザー操作 / User interaction)
            → View.onExit()

---

関連リンク / Related Links

• Next2D Player — WebGL/WebGPU 2D レンダリングエンジン
• Next2D Framework — MVVM フレームワーク
• framework-typescript-template — TypeScript テンプレート
• Create Next2D App — プロジェクト生成ツール
• Next2D Animation Tool — アニメーション作成ツール
• MCP Specification — Model Context Protocol 仕様

License

MIT