Huawei AppGallery MCP

Huawei AppGallery Connect에서 앱 게시를 관리하기 위한 Model Context Protocol (MCP) 서버입니다. Claude Desktop 또는 모든 MCP 호환 클라이언트와 직접 통합됩니다.

기능

• 앱 메타데이터(이름, 설명, 카테고리, 평점, 지원 연락처) 조회 및 업데이트

• 언어별 현지화된 스토어 등록 정보 관리

• 대용량 파일(>4 GB)을 위한 자동 청크 업로드 기능을 갖춘 APK / AAB 파일 업로드

• 전체 출시, 단계적(그레이) 출시, 예약 출시 또는 오픈 테스팅(channel_id=2)을 위한 앱 제출

• 바이너리가 자체 서버에 호스팅된 경우 앱 제출

• 단계적 출시 수명 주기 관리(상태 변경, 비율 업데이트)

• AAB 컴파일 상태 조회

• 예약 출시 시간 업데이트

• GMS 종속성 플래그 설정

• 다운로드/설치 및 설치 실패 보고서 URL 획득

설치

MCP 레지스트리를 통한 설치 (권장)

Claude Code:

claude mcp add --from-registry io.github.AgiMaulana/HuaweiAppGalleryMcp

기타 MCP 클라이언트: registry.modelcontextprotocol.io에서 huawei-appgallery를 검색하세요.

수동 설치

pip install huawei-app-gallery-mcp

또는 uv 사용:

uv pip install huawei-app-gallery-mcp

구성

1. API 자격 증명 획득

1. AppGallery Connect로 이동합니다.

2. 사용자 및 권한 → API 키 → Connect API로 이동합니다.

3. 생성을 클릭하고 앱 관리자(App manager) 역할을 선택합니다.

4. **클라이언트 ID(Client ID)**와 **클라이언트 비밀번호(Client Secret)**를 복사합니다.

이는 Connect API 자격 증명이며, HMS Core 앱 자격 증명과는 다릅니다.

2. 환경 변수 설정

작업 디렉토리에 .env 파일을 생성합니다(서버가 자동으로 로드합니다):

HUAWEI_CLIENT_ID=your_connect_api_client_id
HUAWEI_CLIENT_SECRET=your_connect_api_client_secret

# Optional: set a default app ID so you don't have to pass it to every tool call
HUAWEI_APP_ID=your_app_id

3. MCP 클라이언트 연결 (수동 설치 시에만)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가합니다:

{
  "mcpServers": {
    "huawei-appgallery": {
      "command": "huawei-app-gallery-mcp",
      "env": {
        "HUAWEI_CLIENT_ID": "your_client_id",
        "HUAWEI_CLIENT_SECRET": "your_client_secret",
        "HUAWEI_APP_ID": "your_app_id"
      }
    }
  }
}

Claude Code (머신 레벨, 수동 설치 시에만)

/Library/Application Support/ClaudeCode/managed-mcp.json(macOS) 또는 /etc/claude-code/managed-mcp.json(Linux)을 생성합니다:

{
  "mcpServers": {
    "huawei-appgallery": {
      "type": "stdio",
      "command": "huawei-app-gallery-mcp",
      "env": {
        "HUAWEI_CLIENT_ID": "your_client_id",
        "HUAWEI_CLIENT_SECRET": "your_client_secret",
        "HUAWEI_APP_ID": "your_app_id"
      }
    }
  }
}

도구

모든 도구는 선택적 app_id 인수를 허용합니다. 생략할 경우 환경 변수의 HUAWEI_APP_ID가 기본값으로 사용됩니다.

사용 예시

새 버전 업로드 및 출시:

/path/to/app-release.aab(AAB, 파일 유형 5)를 업로드한 후 전체 출시를 위해 제출합니다.

단계적 출시:

사용자 20%를 대상으로 단계적 출시를 위해 앱을 제출합니다.

오픈 테스팅:

오픈 테스팅을 위해 앱을 제출합니다(channel_id=2).

오픈 테스팅 검사:

query_app_info(channel_id=2)를 사용하여 오픈 테스팅 채널의 앱 메타데이터를 조회합니다.

릴리스 노트 업데이트:

영어 릴리스 노트를 "버그 수정 및 성능 개선"으로 업데이트합니다.

예약 출시:

2026년 3월 20일 10:00 UTC에 출시되도록 앱을 제출합니다.

보고서 다운로드:

지난 30일간의 다운로드 및 설치 보고서 URL을 영어 CSV 형식으로 가져옵니다.

게시 워크플로우

Update app info  →  Update language info  →  Upload APK/AAB  →  Submit app

1. update_app_info / update_language_info를 사용하여 메타데이터 및 릴리스 노트를 설정합니다.

2. upload_app_file을 사용하여 바이너리를 업로드합니다(청크 처리 자동 수행).

3. submit_app을 사용하여 검토 및 출시를 트리거합니다.

패키지 릴리스 워크플로우

패키지 릴리스 지침은 docs/RELEASE.md를 참조하세요.

API 참조

이 서버는 AppGallery Connect Publishing API를 래핑합니다.

라이선스

MIT