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

Related MCP server: MCP Server Generator

概要 / 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:

必要な環境 / Requirements

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

コード生成系 / Code Generation

アーキテクチャ検証 / Architecture Validation

ツール使用例 / 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 / リソース

references ディレクトリ内の Markdown ファイルはすべて自動的にリソースとして登録されます。ファイル名が URI になります（<name>.md → next2d://specs/<name>）。

All markdown files in the references directory are automatically registered as MCP resources. The file name becomes the URI (<name>.md → next2d://specs/<name>).

リソースの追加 / Adding Resources

CLI コマンドで新しいリファレンスリソースを登録できます。ファイルのコピー、SKILL.md の References 更新、README の表更新が自動で行われます。

Register a new reference resource via CLI. It copies the file, updates the SKILL.md references list, and updates the table above automatically.

# このリポジトリで実行（ビルドは pre スクリプトで自動）
npm run add-resource -- path/to/new-spec.md --name new-spec --description "説明"

# インストール済みパッケージからも実行可能
npx next2d-development-mcp add-resource path/to/new-spec.md --name new-spec

# 登録されるリソースの一覧表示
npm run list-resources

Example:

# Next2D Player の仕様から Sprite リファレンスを追加
npm run add-resource -- ../player/specs/ja/sprite.md --name player-sprite --description "Sprite"

追加後は npm run build && npm publish で公開してください。 After adding, run npm run build && npm publish to release the new resource.

情報量のガイドライン / Reference Size Guidelines

AI のコンテキスト負荷を抑えるためのルール。 Rules for keeping the AI context load low.

1. SKILL.md は常時ロードされる → References の各項目は短いトリガー文にする（API名の列挙は避ける）。 SKILL.md is always loaded → keep each references bullet a short trigger phrase (no API enumerations).

2. references はオンデマンド → 1 ファイル = 1 トピック。AI はタスクに必要なファイルだけを1つ読む設計（SKILL.md に明示）。 References are loaded on demand → one file per topic. The agent reads only the single file the task needs (stated in SKILL.md).

3. 2階層構成 → 「クイック」（実装パターン・落とし穴）を入口に、「クラス別フルAPI」（完全版）は詳細確認のときだけ参照。 Two tiers → "quick" (patterns & pitfalls) as the entry point; "per-class full API" only when details are needed.

4. 登録時は --description で短いトリガー文を指定（自動生成は長くなりがち）。 Pass a short --description when registering (auto-generated ones tend to be long).

Prompts / プロンプト

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