Skip to content

v0.1.0 — AssetCacheMCP 첫 PyPI release

Choose a tag to compare

View all tags
@v0o0v v0o0v released this 19 May 16:08
· 66 commits to main since this release
v0.1.0
74bc84d

v0.1.0 — AssetCacheMCP 첫 PyPI release

이전 Game Asset Helper (v0.0.1, GitHub releases 의 단일 exe) 에서 PyPI 1차 배포 + 패키지명 rename 한 v2 의 첫 release.

PyPI: https://pypi.org/project/assetcache-mcp/0.1.0/

설치

권장 — pipx (격리된 venv 자동 관리):

pipx install assetcache-mcp

또는 uv:

uv tool install assetcache-mcp

또는 일반 pip:

pip install assetcache-mcp

설치 후 명령:

  • assetcache --tray — 트레이 앱 부팅 (브라우저 자동 진입, http://127.0.0.1:9874)
  • assetcache --mcp 또는 assetcache-mcp — MCP stdio 서버 (Claude Desktop config 에서 사용)
  • assetcache --version — 버전 확인

이전 v0.0.1 사용자 마이그레이션

v0.0.1 (Game Asset Helper) 의 사용자 데이터는 %APPDATA%\GameAssetHelper\ 에 저장됐다. v0.1.0 부터는 %APPDATA%\AssetCacheMCP\ 로 이동.

자동 마이그레이션 helper 제공:

  1. 웹 UI 배너 — assetcache --tray 부팅 시 라이브러리 페이지 상단에 마이그레이션 배너 자동 표시. "Copy" (보존) 또는 "Move" (옮김) 클릭으로 진행. SSE 진행률 + 디스크 공간 검사 + 실패 시 rollback
  2. CLI 헤드리스 — assetcache --migrate=copy 또는 --migrate=move 로 GUI 없이 실행

⚠️ Claude Desktop config 의 mcpServers 는 자동 마이그레이션 X — 직접 갱신 필요:

  • 이전: python -m gah --mcp
  • 신규: python -m assetcache --mcp 또는 assetcache-mcp (콘솔 스크립트)

주요 변경 (v0.0.1 → v0.1.0)

배포 방식

  • PyPI 1차 배포 — Windows / Mac / Linux 동시 지원 (단 Mac/Linux 는 v0.1.0 에서 미검증)
  • 단일 exe (PyInstaller 308 MB) 는 부속 옵션 — v0.0.1 사용자만 대상

Rename

  • 패키지명: game-asset-helper → assetcache-mcp
  • CLI: python -m gah → python -m assetcache 또는 assetcache
  • 콘솔 스크립트: assetcache (트레이/MCP 통합) + assetcache-mcp (MCP stdio 전용)
  • 사용자 데이터 폴더: %APPDATA%\GameAssetHelper\ → %APPDATA%\AssetCacheMCP\

신규 기능

  • v0.0.1 자동 데이터 마이그레이션 (배너 + CLI)
  • PyPI 신버전 알림 — _pypi_update_banner.html Alpine + 트레이 메뉴 동적, ETag 캐시, 24시간 폴링
  • 트레이 동적 메뉴 — _TrayBridge(QObject) + Signal(object) 으로 cross-thread 안전
  • pipx / uv / pip 환경 자동 감지 후 사용자에게 적절한 upgrade 명령 추천

누적 (M0~M9 + M10)

  • 20 MCP 도구 (M5 의 17 + M6 의 suggest_animation_frames + M7 의 Unity Asset Store import 2 도구)
  • ko/en i18n (Babel + .mo) + 다크모드 토글 + Windows autostart
  • 1103 자동 테스트 통과 (M0~M9 1046 + M10 +57)

자동 publish (Trusted Publishing)

이후 release 는 tag push 한 줄로 자동 publish:

git tag v0.1.1
git push origin v0.1.1

GitHub Actions workflow (.github/workflows/publish.yml) 가 OIDC trusted publishing 으로 PyPI 인증 (API token 없음).

알려진 한계

  • Mac / Linux 미검증 — v0.1.0 은 Windows 10 (Python 3.12) 에서만 검증. PyPI install 흐름은 cross-platform 호환되지만 별도 마일스톤에서 정식 검증
  • Claude Desktop config 자동 마이그레이션 X — 위 마이그레이션 섹션 참고
  • 마이그레이션 idempotency — .migrated_from_v001 마커 파일로 1회만 동작 (안전 장치). 재실행 필요 시 마커 수동 삭제
  • PyPI publish 가 첫 release 는 수동 — 이후 tag push 부터 자동
Assets 2
Loading