Abidil98/shopmium-mcp-server

Shopmium MCP Server

A custom MCP server that provides high-level tools for controlling Shopmium and Quoty apps on Android emulators.

Installation

# Clone the repository
git clone https://github.com/Abidil98/shopmium-mcp-server.git

# Navigate to the directory
cd shopmium-mcp-server

# Install dependencies
npm install

Usage

Starting the server

npm start

Adding to Cline MCP settings

Add the following to your Cline MCP settings file:

"github.com/Abidil98/shopmium-mcp-server": {
  "timeout": 60,
  "command": "node",
  "args": [
    "C:/Users/Admin/shopmium-mcp-server/index.js"
  ],
  "transportType": "stdio"
}

Available Tools

select_device

Select an Android device to use.

{
  "device": "emulator-5554"  // Optional, defaults to emulator-5554
}

launch_shopmium

Launch the Shopmium app.

{}

launch_quoty

Launch the Quoty app.

{}

shopmium_navigate_to_tab

Navigate to a specific tab in the Shopmium app.

{
  "tab": "reimburse"  // One of: offers, categories, reimburse, loyaltyCards, purchases
}

shopmium_navigate_to_top_tab

Navigate to a specific top tab in the Shopmium app.

{
  "tab": "home"  // One of: home, shopmiumParty, newItems, laundryCare
}

take_screenshot

Take a screenshot of the current screen.

{}

swipe_screen

Swipe up or down on the screen.

{
  "direction": "up"  // One of: up, down
}

click_at_coordinates

Click at specific coordinates on the screen.

{
  "x": 100,
  "y": 200
}

type_text

Type text into the focused element.

{
  "text": "Hello, world!",
  "submit": true  // Optional, defaults to false
}

terminate_app

Terminate an app.

{
  "app": "shopmium"  // One of: shopmium, quoty
}

Example Usage in Cline

I want to launch Shopmium and navigate to the Reimburse tab.

The LLM will use the custom MCP server to:

1. Select the device
2. Launch Shopmium
3. Navigate to the Reimburse tab

All without having to rediscover package names or UI element coordinates.