google-play-mcp 1.0.0

package/.env.example

@@ -0,0 +1,2 @@
+GOOGLE_PLAY_KEY_FILE="path/to/key.json"
+GOOGLE_PLAY_PACKAGE_NAME="com.example.app"

package/README.md

@@ -0,0 +1,208 @@
+# Google Play Developer API MCP Server
+
+A Model Context Protocol (MCP) server for managing Google Play app deployment and in-app products via the Android Publisher API v3.
+
+## Features
+
+### App Deployment
+
+- **deploy_internal**: Upload AAB and deploy to internal testing track
+
+### In-App Products
+
+- **create_inapp_product**: Create or update a single in-app product
+- **batch_create_inapp_products**: Create multiple products at once
+- **activate_inapp_product**: Activate a draft product
+- **batch_activate_inapp_products**: Activate multiple products
+- **deactivate_inapp_product**: Deactivate an active product
+- **list_inapp_products**: List all one-time products
+- **list_subscriptions**: List all subscription products
+
+### App Info
+
+- **get_app_info**: Get app track and version information
+
+## Requirements
+
+- Python 3.10+
+- Google Cloud service account with Google Play Developer API access
+- App registered in Google Play Console
+
+## Installation & Usage
+
+You can use this MCP server directly with `npx` without installing it manually.
+
+### Quick Start (npx)
+
+```bash
+# Configure your API key
+npx google-play-mcp init-key
+
+# For Korean instructions (한국어 안내)
+npx google-play-mcp init-key --lang ko
+
+# Start the server
+npx google-play-mcp start
+```
+
+### Installation (Global)
+
+If you prefer to install it globally (from npm):
+
+```bash
+npm install -g google-play-mcp
+```
+
+### Installation (Local Dev)
+
+To install from the cloned repository:
+
+```bash
+npm install -g .
+```
+
+Then you can run:
+
+```bash
+google-play-mcp init-key
+google-play-mcp start
+```
+
+## Configuration (Antigravity & Claude Desktop)
+
+To use this MCP server, add the following configuration to your MCP client (e.g., `claude_desktop_config.json` or Antigravity settings):
+
+```json
+{
+  "mcpServers": {
+    "google-play": {
+      "command": "google-play-mcp",
+      "args": ["start"],
+      "env": {
+        "GOOGLE_PLAY_KEY_FILE": "/absolute/path/to/your-key.json",
+        "GOOGLE_PLAY_PACKAGE_NAME": "com.yourcompany.yourapp"
+      }
+    }
+  }
+}
+```
+
+> **Note:** If you haven't run `init-key` or don't have a `.env` file, you can pass environment variables directly in the configuration as shown above. If you have a `.env` file in the working directory, the server will load it automatically.
+
+1. Login to npm:
+
+```bash
+npm login
+```
+
+1. Publish the package:
+
+```bash
+npm publish
+```
+
+## Configuration
+
+The `npm run init-key` script will automatically create a `.env` file with your configuration:
+
+```
+GOOGLE_PLAY_KEY_FILE=/absolute/path/to/your-key.json
+GOOGLE_PLAY_PACKAGE_NAME=com.yourcompany.yourapp
+```
+
+## Usage
+
+To start the server manually:
+
+```bash
+npm start
+```
+
+### Usage with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "google-play": {
+      "command": "npm",
+      "args": ["start"],
+      "cwd": "/absolute/path/to/google-play-mcp"
+    }
+  }
+}
+```
+
+## Tool Examples
+
+### Deploy to Internal Testing
+
+```
+Deploy app-release.aab to internal testing with Korean and English release notes
+```
+
+### Create In-App Product
+
+```
+Create an in-app product:
+- SKU: gems_100
+- Korean: 보석 100개 / 보석 100개를 획득합니다
+- English: 100 Gems / Get 100 gems
+- Price: $0.99 USD
+```
+
+### Batch Create Products
+
+```json
+[
+  {"sku": "gems_12", "title_ko": "보석 12개", "title_en": "12 Gems",
+   "description_ko": "보석 12개 획득", "description_en": "Get 12 gems", "price_usd": 0.99},
+  {"sku": "gems_66", "title_ko": "보석 66개", "title_en": "66 Gems",
+   "description_ko": "보석 66개 획득", "description_en": "Get 66 gems", "price_usd": 4.99}
+]
+```
+
+### Activate Products
+
+```json
+["gems_12", "gems_66", "gems_136"]
+```
+
+## Important Notes
+
+### Prerequisites for In-App Products
+
+Before creating in-app products, your app must have:
+
+1. `com.android.vending.BILLING` permission in `AndroidManifest.xml`
+2. Play Billing Library 6.0.1+ (Flutter: `in_app_purchase` package)
+3. A bundle with these uploaded to Google Play
+
+### Draft Apps
+
+Apps that have never been published can only use `status: "draft"` for deployments.
+You must manually publish through Google Play Console for the first release.
+
+### API Migration
+
+This server uses the new `monetization.onetimeproducts` API instead of the deprecated
+`inappproducts` API which returns 403 errors.
+
+### Price Conversion
+
+USD prices are automatically converted to 170+ regional currencies using
+Google's `convertRegionPrices` API.
+
+## Tracks
+
+| Track | Description |
+|-------|-------------|
+| `internal` | Internal testing (up to 100 testers) |
+| `alpha` | Closed testing |
+| `beta` | Open testing |
+| `production` | Production release |
+
+## License
+
+MIT License

package/bin/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+// Determine the root directory of the package
+const packageRoot = path.join(__dirname, '..');
+const venvDir = path.join(packageRoot, '.venv');
+const requirementsFile = path.join(packageRoot, 'requirements.txt');
+
+// Platform specific paths
+const isWindows = process.platform === 'win32';
+const pythonExecutable = isWindows
+    ? path.join(venvDir, 'Scripts', 'python.exe')
+    : path.join(venvDir, 'bin', 'python');
+
+const pipExecutable = isWindows
+    ? path.join(venvDir, 'Scripts', 'pip.exe')
+    : path.join(venvDir, 'bin', 'pip');
+
+function runCommand(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, {
+            stdio: 'inherit',
+            cwd: packageRoot,
+            ...options
+        });
+
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            } else {
+                reject(new Error(`Command exited with code ${code}`));
+            }
+        });
+
+        proc.on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+
+async function setupEnvironment() {
+    console.log('Initializing Python virtual environment...');
+
+    // Create venv if it doesn't exist
+    if (!fs.existsSync(venvDir)) {
+        console.log('Creating .venv...');
+        try {
+            await runCommand('python3', ['-m', 'venv', '.venv']);
+        } catch (e) {
+            // Try just 'python' if 'python3' fails (e.g. Windows)
+            await runCommand('python', ['-m', 'venv', '.venv']);
+        }
+    }
+
+    // Install dependencies
+    if (fs.existsSync(requirementsFile)) {
+        console.log('Installing dependencies...');
+        await runCommand(pipExecutable, ['install', '-r', 'requirements.txt']);
+    }
+}
+
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+
+    // Check if environment needs setup
+    if (!fs.existsSync(pythonExecutable)) {
+        try {
+            await setupEnvironment();
+        } catch (error) {
+            console.error('Failed to setup Python environment:', error);
+            process.exit(1);
+        }
+    }
+
+    // Determine which script to run
+    let scriptToRun;
+    let pythonArgs = [];
+
+    if (command === 'init-key') {
+        scriptToRun = 'setup_key.py';
+        pythonArgs = args.slice(1);
+    } else if (command === 'start' || !command) {
+        scriptToRun = 'server.py';
+        pythonArgs = args.slice(1);
+        if (command === 'start') {
+            pythonArgs = args.slice(1); // 'start' is consumed
+        } else {
+            pythonArgs = args; // No command provided, pass all args
+        }
+    } else {
+        // Unknown command, maybe it's an arg for server.py?
+        // Default to running server.py with these args
+        scriptToRun = 'server.py';
+        pythonArgs = args;
+    }
+
+    const scriptPath = path.join(packageRoot, scriptToRun);
+
+    try {
+        await runCommand(pythonExecutable, [scriptPath, ...pythonArgs]);
+    } catch (error) {
+        console.error('Error executing script:', error);
+        process.exit(1);
+    }
+}
+
+main();

package/locales.json

@@ -0,0 +1,58 @@
+{
+    "en": {
+        "step1_title": "Step 1: Enable Google Play API",
+        "step1_desc": "\n1. Create a new project or select an existing one.\n2. Click **Enable** for **\"Google Play Android Developer API\"**.\n        ",
+        "step2_title": "Step 2: Create Service Account & Download Key",
+        "step2_desc": "\n1. Click **Create Service Account**.\n2. Fill in the suggested details below (Select options to copy).\n3. Click **Create and Continue**.\n4. Click **Done** (Granting Service Account User role is optional).\n5. Click on the **Email** of the newly created account.\n6. Go to the **Keys** tab (top menu).\n7. Click **Add Key** > **Create new key** > **JSON** > **Create**.\n8. The JSON file will download. **Keep this file ready.**\n        ",
+        "step3_title": "Step 3: Grant Permissions in Play Console",
+        "step3_desc": "\n1. Have your **Service Account Email** ready (from Step 2).\n2. Click **Invite new users**.\n3. Paste the service account email.\n4. Grant **Admin** permissions (or at least Release & Financial).\n5. Click **Invite user**.\n        ",
+        "open_browser": "\nOpen browser to perform this step? (Press Enter to Open) [y/N]",
+        "sa_details_title": "Service Account Details",
+        "sa_suggested_title": "[bold]Suggested Values (Double-click or drag to select):[/bold]",
+        "sa_name_label": "Service Account Name:",
+        "sa_id_label": "Service Account ID:",
+        "sa_desc_label": "Description:",
+        "copy_menu_intro": "\n[dim]You can use the menu below to copy values to your clipboard, or copy them manually from above.[/dim]",
+        "copy_menu_prompt": "\n[bold]Copy Actions (Optional):[/bold]\n[1] Copy Name & ID (Formatted Text)\n[2] Copy Description\n[Enter] Skip / Continue to next step",
+        "final_config_title": "[bold green]Final Configuration[/bold green]",
+        "key_path_prompt": "\n[bold]Drag and drop (or enter path)[/bold] to your downloaded JSON key file",
+        "key_file_error": "[bold red]Error:[/bold red] File not found at {key_path}. Please try again.",
+        "package_name_prompt": "Enter your [bold]App Package Name[/bold] (e.g. com.example.app)",
+        "success_msg": "\n[bold green]Success![/bold green] Configured .env\nKey: {key_path}\nPackage: {package_name}",
+        "pyperclip_install": "[yellow]pyperclip not found. Installing...[/yellow]",
+        "pyperclip_error": "[red]Failed to import pyperclip after installation.[/red]",
+        "copy_manual": "Please copy manually: [bold]{text}[/bold]",
+        "copy_install_fail": "[red]Failed to install pyperclip.[/red]",
+        "copy_success": "[green]Copied to clipboard: {text}[/green]",
+        "copy_fail": "[red]Failed to copy to clipboard: {e}[/red]",
+        "press_enter": "Press Enter key inside this terminal after you have completed the steps above..."
+    },
+    "ko": {
+        "step1_title": "1단계: Google Play API 활성화",
+        "step1_desc": "\n1. 새 프로젝트를 생성하거나 기존 프로젝트를 선택하세요.\n2. **\"Google Play Android Developer API\"**를 찾아 **사용(Enable)**을 클릭하세요.\n        ",
+        "step2_title": "2단계: 서비스 계정 생성 및 키 다운로드",
+        "step2_desc": "\n1. **서비스 계정 만들기**를 클릭하세요.\n2. 아래 제안된 내용을 복사하여 입력하세요.\n3. **만들기 및 계속**을 클릭하세요.\n4. **완료**를 클릭하세요 (권한 부여는 선택 사항입니다).\n5. 새로 생성된 계정의 **이메일**을 클릭하세요.\n6. **키** 탭(상단 메뉴)으로 이동하세요.\n7. **키 추가** > **새 키 만들기** > **JSON** > **만들기**를 클릭하세요.\n8. JSON 파일이 다운로드됩니다. **이 파일을 잘 보관하세요.**\n        ",
+        "step3_title": "3단계: Play Console에서 권한 부여",
+        "step3_desc": "\n1. **서비스 계정 이메일**을 준비하세요 (2단계에서 생성됨).\n2. **사용자 초대**를 클릭하세요.\n3. 서비스 계정 이메일을 붙여넣으세요.\n4. **관리자** 권한(또는 최소한 출시 및 금융 권한)을 부여하세요.\n5. **사용자 초대**를 클릭하세요.\n        ",
+        "open_browser": "\n이 단계를 수행하기 위해 브라우저를 여시겠습니까? (엔터를 누르면 열립니다) [y/N]",
+        "sa_details_title": "서비스 계정 상세 정보",
+        "sa_suggested_title": "[bold]추천 값 (더블 클릭하거나 드래그하여 선택):[/bold]",
+        "sa_name_label": "서비스 계정 이름:",
+        "sa_id_label": "서비스 계정 ID:",
+        "sa_desc_label": "설명:",
+        "copy_menu_intro": "\n[dim]아래 메뉴를 사용하여 클립보드에 복사하거나, 위 내용을 수동으로 복사하세요.[/dim]",
+        "copy_menu_prompt": "\n[bold]복사 작업 (선택 사항):[/bold]\n[1] 이름 & ID 복사 (서식 포함)\n[2] 설명 복사\n[Enter] 건너뛰기 / 다음 단계로 계속",
+        "final_config_title": "[bold green]최종 설정[/bold green]",
+        "key_path_prompt": "\n다운로드한 JSON 키 파일을 이곳에 [bold]드래그 앤 드롭[/bold] (또는 경로 입력) 하세요",
+        "key_file_error": "[bold red]오류:[/bold red] 파일을 찾을 수 없습니다: {key_path}. 다시 시도해주세요.",
+        "package_name_prompt": "[bold]앱 패키지 이름[/bold]을 입력하세요 (예: com.example.app)",
+        "success_msg": "\n[bold green]성공![/bold green] .env 설정 완료\n키: {key_path}\n패키지: {package_name}",
+        "pyperclip_install": "[yellow]pyperclip을 찾을 수 없습니다. 설치 중...[/yellow]",
+        "pyperclip_error": "[red]설치 후 pyperclip을 가져오는데 실패했습니다.[/red]",
+        "copy_manual": "수동으로 복사해주세요: [bold]{text}[/bold]",
+        "copy_install_fail": "[red]pyperclip 설치에 실패했습니다.[/red]",
+        "copy_success": "[green]클립보드에 복사되었습니다: {text}[/green]",
+        "copy_fail": "[red]클립보드 복사 실패: {e}[/red]",
+        "press_enter": "위 단계를 완료한 후 이 터미널에서 Enter 키를 누르세요..."
+    }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+    "name": "google-play-mcp",
+    "version": "1.0.0",
+    "description": "MCP server for Google Play Developer API",
+    "scripts": {
+        "start": "node bin/cli.js start",
+        "init-key": "node bin/cli.js init-key"
+    },
+    "bin": {
+        "google-play-mcp": "./bin/cli.js"
+    },
+    "files": [
+        "server.py",
+        "setup_key.py",
+        "requirements.txt",
+        "bin/cli.js",
+        ".env.example",
+        "locales.json"
+    ],
+    "preferGlobal": true,
+    "keywords": [
+        "mcp",
+        "google-play",
+        "python"
+    ],
+    "author": "",
+    "license": "MIT"
+}

package/requirements.txt

@@ -0,0 +1,5 @@
+mcp[cli]>=1.0.0
+google-api-python-client>=2.100.0
+google-auth>=2.23.0
+python-dotenv>=1.0.0
+pyperclip>=1.8.0