완전한, Local Model Context Protocol (MCP) 서버는 Pure Dart에서 Automate, Audit에 작성되었으며 Flutter 프로젝트 자산 및 현지화 구조를 최적화합니다. Cursor 또는 Claude Desktop과 같은 AI 클라이언트에 연결하여 AI가 프로젝트의 자산 및 번역 구조와 직접 상호 작용할 수 있습니다.

---

♨ 특징

AssetGenie는 LLM 컨텍스트에 5 가지 강력한 도구를 노출합니다.

##1. assetgenie_audit_health 프로젝트의 pubspec.yaml 및 물리적 폴더를 스캔하여 자산을 식별합니다.

• pubspec.yaml]에 선언된 물리적 파일이 없는 플래그.
• pubspec.yaml] (undeclared Asset)에 선언되지 않은 물리적 자산.
• 구성 가능한 파일 크기 임계값 (기본값: 500 KB)를 초과하는 무거운 자산을 식별합니다.
• lib/] 소스 코드의 참조를 검색하여 사용되지 않은 물리적 파일에 대한 자동 검사.

##2. assetgenie_sync_localization 안전한 업데이트 또는 로컬 응용 프로그램 리소스 번들 (.arb]) 파일로 번역 키를 주사:

• 수동 복사 / pasting없이 새로운 번역을 승인합니다.
• 형식 및 그룹 메타 데이터 키 (@key]])를 각각 속성 옆에 표준화합니다.
• 표준 ARB 지침에 따라 키 알파벳.

# # # 3.

AssetGenie 🧞‍♂️

A complete, local Model Context Protocol (MCP) server written in pure Dart to automate, audit, and optimize Flutter project assets and localization structure. Connect it to AI clients like Cursor or Claude Desktop to let the AI interact directly with your project’s assets and translation structures.

---

🚀 Features

AssetGenie exposes five powerful tools to the LLM context:

1. assetgenie_audit_health

Scans the project’s pubspec.yaml and physical folders to identify asset anomalies:

• Flags missing physical files declared in pubspec.yaml.
• Flags physical assets that are not declared in pubspec.yaml (undeclared assets).
• Identifies heavy assets exceeding a configurable file size threshold (default: 500 KB).
• Automatically checks for unused physical files by searching for references in lib/ source code.

2. assetgenie_sync_localization

Safely updates or injects translation keys into local Application Resource Bundle (.arb) files:

• Appends new translations without manual copying/pasting.
• Standardizes formatting and groups metadata keys (@key) next to their respective properties.
• Alphabetizes keys according to standard ARB guidelines.

3. assetgenie_generate_constants

Auto-generates clean, modern Dart constants from physical asset files:

• Recursively walks through the physical assets folders.
• Converts file paths into structured camelCase variable names.
• Resolves identifier collisions and reserved keywords dynamically.
• Writes a safe config class Assets inside lib/generated/ to prevent typos and hardcoded string values.

4. assetgenie_audit_localization

Audits the project’s ARB localization files to ensure quality and consistency:

• Compares target locales against a primary locale to find missing translation keys.
• Detects extra translation keys defined in target locales but missing in the primary locale.
• Validates that parameterized placeholders (e.g., {name}) match between translations to prevent runtime formatting crashes.
• Scans Dart code recursively in lib/ to identify unused translation keys.

5. assetgenie_app_harness

Connects to a running Flutter application via its Dart VM Service to inspect layout, capture state, or stream logs:

• Retrieves a clean, structured JSON Widget Summary Tree from the active application context.
• Requests a live PNG screenshot of the application’s current layout, returning it directly in the tool response.
• Streams and captures stdout/stderr console prints and runtime logging statements over WebSocket.

---

🛠️ Installation & Setup

Ensure you have Dart SDK installed on your system.

1. Clone the repository:

   git clone https://github.com/aditzeb/AssetGenie.git
   cd AssetGenie
   

2. Download package dependencies: