RuStore MCP Server

MCP server for managing app publishing on RuStore (Android app store). Provides 34 tools: APK/AAB uploads, icon and screenshot management, version control, moderation, reviews, payments, subscriptions, access control, and product catalog.

Status

[!WARNING] The package is not yet published to PyPI. Only local installation is available at this time.

Prerequisites

• Python 3.11+
• RuStore Console API key (keyId + Base64-encoded private key)

Local Installation

Windows (PowerShell)

git clone https://github.com/eustatos/RuStoreMcp.git
cd RuStoreMcp
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"

Windows (CMD)

git clone https://github.com/eustatos/RuStoreMcp.git
cd RuStoreMcp
python -m venv .venv
.venv\Scripts\activate.bat
pip install -e ".[dev]"

macOS / Linux

git clone https://github.com/eustatos/RuStoreMcp.git
cd RuStoreMcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

After installation, the rustore-mcp executable (rustore-mcp.exe on Windows) is available inside the virtual environment at:

Configuration

Create a .env file in the project root based on .env.example:

RUSTORE_KEY_ID=your_key_id
RUSTORE_PRIVATE_KEY=your_base64_private_key
RUSTORE_PACKAGE_NAME=com.example.app  # optional

• RUSTORE_KEY_ID — key identifier from RuStore Console
• RUSTORE_PRIVATE_KEY — Base64-encoded private key
• RUSTORE_PACKAGE_NAME — default package name (can be overridden per-request)

Usage

Direct execution

# Windows
.venv\Scripts\rustore-mcp.exe

# macOS / Linux
.venv/bin/rustore-mcp

Claude Desktop integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

Windows:

{
  "mcpServers": {
    "rustore": {
      "command": "C:\\Users\\<user>\\path\\to\\RuStoreMcp\\.venv\\Scripts\\rustore-mcp.exe",
      "env": {
        "RUSTORE_KEY_ID": "your_key_id_here",
        "RUSTORE_PRIVATE_KEY": "your_base64_private_key_here",
        "RUSTORE_PACKAGE_NAME": "com.example.app"
      }
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "rustore": {
      "command": "/path/to/RuStoreMcp/.venv/bin/rustore-mcp",
      "env": {
        "RUSTORE_KEY_ID": "your_key_id_here",
        "RUSTORE_PRIVATE_KEY": "your_base64_private_key_here",
        "RUSTORE_PACKAGE_NAME": "com.example.app"
      }
    }
  }
}

Logging

Log level is controlled via the RUSTORE_LOG_LEVEL environment variable:

# Windows (CMD)
set RUSTORE_LOG_LEVEL=DEBUG
.venv\Scripts\rustore-mcp.exe

# macOS / Linux
RUSTORE_LOG_LEVEL=DEBUG .venv/bin/rustore-mcp

Supported values: DEBUG, INFO, WARNING, ERROR, CRITICAL. Default: INFO.

Available Tools (34)

Publishing

Reviews & Rating

Payments

Subscriptions

Access & Catalog

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run all tests
pytest -v

# Run tests with coverage
pytest -v --cov=rustore_mcp --cov-report=term-missing

# Type checking
mypy rustore_mcp/

# Run a single test file
pytest tests/test_auth.py -v

License

MIT