text2d — 2DレトロピクセルアートテクスチャMCPサーバー

ゲーム開発用に、AIアシスタントが2Dレトロピクセルアートのテクスチャやタイルセットを手続き的に生成・操作・エクスポートできるようにする、高性能なModel Context Protocol (MCP)サーバーです。

特徴

• 画像からレトロピクセルアートへの変換: 外部PNGファイルを取り込み、自動でダウンスケール、レトロパレットへの量子化、pixelize_imageによるBayerディザリングを適用します。

• 手続き的テクスチャ合成: wood、stone（玉石/岩）、brick、grass、metal（リベット付きブラッシュプレート）、water（コースティクス）を決定的に生成します。

• ピクセルレベルのプリミティブ: set_pixel、set_pixel_batch、draw_shape（直線、矩形、円）、flood_fillによる完全な制御を提供します。

• レトロパレットと量子化: PICO-8、DawnBringer 32 (DB32)、Endesga 32、GameBoy、NES Classic、Cyberpunk Neonなどの本格的なカラーパレットを内蔵しています。

• ピクセルアート後処理: Bayerオーダードディザリング（2x2、4x4、8x8）と、1pxの内側/外側ピクセルパーフェクトアウトラインを適用できます。

• エクスポートオプション: 最近傍整数スケーリングによるPNGファイル、Base64 Data URI、ASCII Unicodeブロックプレビュー、2D JSONカラーグリッドを出力できます。

Related MCP server: Piskel MCP Server

ビジュアル例とギャラリー

1. 画像のピクセル化（pixelize_image）

高解像度のリアルな写真やアセットを、自動パレット量子化とBayerディザリングで本格的なレトロピクセルアートに変換します。

2. 手続き的テクスチャ合成（generate_texture）

外部アセットなしで、シームレスで決定的なレトロテクスチャを数秒で生成します。

MCPツールマトリックス

インストールと使用方法

text2dはnpmに公開せず、GitHubから直接インストールして実行できます：

1. グローバルインストール（推奨）

GitHubリポジトリから直接グローバルにインストールします：

npm install -g github:al3duc/text2d-mcp

インストール後、text2dコマンドがシステム全体で利用可能になります。

MCPクライアント設定

text2dをMCPクライアント設定（例：claude_desktop_config.json、mcp_config.json、Cursor）に追加します：

オプションA：グローバルインストールを使用（最も簡単）

{
  "mcpServers": {
    "text2d": {
      "command": "text2d"
    }
  }
}

オプションB：npxによる直接実行（永続的なインストール不要）

{
  "mcpServers": {
    "text2d": {
      "command": "npx",
      "args": [
        "-y",
        "github:al3duc/text2d-mcp"
      ]
    }
  }
}

オプションC：Claude Code CLIコマンド

Claude Codeを使用する場合は、単一のターミナルコマンドで登録します：

claude mcp add text2d -- npx -y github:al3duc/text2d-mcp

オプションD：ローカルクローン（開発用）

git clone https://github.com/al3duc/text2d-mcp.git
cd text2d-mcp
npm install
npm run build

{
  "mcpServers": {
    "text2d": {
      "command": "node",
      "args": [
        "<PATH_TO_TEXT2D_REPOSITORY>/dist/index.js"
      ]
    }
  }
}

注：<PATH_TO_TEXT2D_REPOSITORY>を、クローンしたリポジトリの絶対パスに置き換えてください。

ビルドとテスト

# Install dependencies
npm install

# Run unit & integration tests
npm test

# Build TypeScript to dist/
npm run build

# Generate procedural texture samples (wood, stone, brick, grass, metal, water)
npx tsx examples/generate_samples.ts

# Test converting realistic images from examples/input/ to pixel art
npx tsx examples/test_car_pixelize.ts

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルを参照してください。