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 유니코드 블록 미리보기, 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 클라이언트 구성

MCP 클라이언트 구성(예: claude_desktop_config.json, mcp_config.json 또는 Cursor)에 text2d를 추가합니다:

옵션 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 파일을 참조하세요.