{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_xsjyxd3uzcth","handle":"assetcache-mcp","url":"https://wellknown.network/agents/assetcache-mcp","links":{"self":"https://wellknown.network/agents/assetcache-mcp/record.json","html":"https://wellknown.network/agents/assetcache-mcp","markdown":"https://wellknown.network/agents/assetcache-mcp/record.md","api":"https://wellknown.network/api/v1/agents/assetcache-mcp","status":"https://wellknown.network/api/v1/agents/assetcache-mcp/status","claim":"https://wellknown.network/agents/assetcache-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/assetcache-mcp/claim.json","badge":"https://wellknown.network/agents/assetcache-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:assetcache-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"assetcache-mcp","summary":"MCP server + tray app for indexing and retrieving 2D sprites, sheets, sounds, and Unity packages via natural language.","description":"# AssetCacheMCP\n\nUnity 게임 개발 중 Claude Code가 보유 에셋(2D 스프라이트, 스프라이트 시트, 사운드)을 자연어로 요청하면 가장 적합한 후보를 돌려주는 **MCP 서버 + 윈도우즈 트레이 상주 앱**.\n\n- 사용자가 `library/<pack>/...` 형태로 에셋 팩 폴더를 통째로 드롭하면 자동 인덱싱\n- Ollama로 도는 **Gemma 4**(`gemma4:e4b`)가 이미지·오디오를 직접 보고 의미 라벨 생성\n- 한 프로젝트에서 한 번 채택한 팩을 이후 검색에서 우선시해 **통일성 유지**\n- 트레이 부팅 → **브라우저 자동 진입** (`http://127.0.0.1:9874`) — FastAPI + HTMX + Alpine.js 기반 웹 UI\n- Unity Asset Store 로컬 캐시(`.unitypackage`)도 자동 임포트\n- 시트 분할 + 애니메이션 프레임 추론 (`suggest_animation_frames`)\n- **PyPI 권장 설치** (`pipx install assetcache-mcp`) — 현재 Windows 1차 지원 (Mac/Linux 는 install 흐름이 cross-platform 호환되지만 정식 검증은 미진행)\n- 한국어/영어 i18n + 다크모드 + Windows 자동 시작 + PyPI 신버전 알림\n\n전체 설계는 [`DESIGN.md`](./DESIGN.md). 웹 UI 상세 사용법은 [`docs/WEB_UI_GUIDE.md`](./docs/WEB_UI_GUIDE.md).\n\n## 주요 기능\n\n| 기능 | 설명 |\n|---|---|\n| **에셋 라이브러리 검색** | 자연어 쿼리 + 300ms 디바운스. 의미/키워드/라벨/통일성 6채널 하이브리드 검색 |\n| **라이브러리 페이지** (`/library`) | 카드 그리드/리스트 + 사이드 패널 (B/C/D 탭) + 상세 모달 + 사운드 인라인 재생 |\n| **팩 관리 페이지** (`/packs`) | 등록된 팩 카드 그리드 + 활성/비활성 토글 |\n| **라벨 admin 페이지** (`/labels/admin`) | 24 axis 탭 + 라벨 CRUD + JSON import/export |\n| **Claude pick 인터랙션** | MCP 도구 `request_user_pick` — Claude가 후보를 고르면 브라우저에 보라색 선택 카드 출현 |\n| **통일성 가중 검색** | 프로젝트별 사용 이력 추적 → 같은 팩·벤더 우선 추천 |\n| **MCP 20 도구** | `find_asset`, `suggest_packs`, `record_asset_use`, `request_user_pick`, `suggest_animation_frames`, `import_unity_package` 등 |\n| **다크 모드** | OS `prefers-color-scheme` 자동 반영 |\n| **PyPI 신버전 알림** | 부팅 시 PyPI JSON API 조회 → 신버전 시 웹 배너 + 트레이 메뉴 안내 |\n\n## 진행 현황\n\n| 마일스톤 | 상태 | 비고 |\n|---|---|---|\n| M0 — 뼈대 | ✅ 완료 | 트레이 셸·설정·로깅·단일 인스턴스 |\n| M1 — 워처 + Pack Manager + DB | ✅ 완료 | watchdog, SQLite 4테이블, 부팅 풀스캔 |\n| M2 — 분석 파이프라인 + CLIP | ✅ 완료 | Pillow/librosa/Gemma 4/CLIP, 24 axis 라벨 시드 |\n| M2.1 — 병렬화 패치 | ✅ 완료 | 동시성 1→3, Ollama semaphore |\n| M3 — 검색 백엔드 + 통일성 + MCP | ✅ 완료 | HybridSearcher, 12 MCP 도구 |\n| M4 — 검색 UX 풍부화 | ✅ 완료 (main 머지) | label_query AND/OR/NOT, 16 MCP 도구 |\n| M5 — 웹 GUI 전환 + Claude pick | ✅ 완료 (main 머지) | FastAPI 웹 UI + Qt 폐기, 17 MCP 도구 |\n|…","publisher":null,"homepage":"https://github.com/v0o0v/assetcache-mcp/blob/main/README.md","repository":"https://github.com/v0o0v/assetcache-mcp/blob/main/README.md","version":"0.2.7","license":"MIT License\n        \n        Copyright (c) 2026 Game Asset Help…","protocols":["mcp"],"tags":["mcp","unity","asset","game-development","claude"],"pricing":null,"endpoints":[{"url":"pypi:assetcache-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":0.768,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"assetcache-mcp","registry":"pypi","observedAt":"2026-09-09T09:25:10.516Z","publishedAt":"2026-05-22T06:50:34.458591Z","latestVersion":"0.2.7"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"assetcache-mcp","url":"https://pypi.org/project/assetcache-mcp/","firstSeenAt":"2026-09-09T09:23:58.460Z","fetchedAt":"2026-09-09T09:23:58.460Z","normalizedAt":"2026-09-09T09:23:58.460Z"}]},"firstSeenAt":"2026-09-09T09:23:58.460Z","updatedAt":"2026-09-09T09:25:10.516Z"}