Promptium

by sycophant21

309 downloads

Not rated

GitHub

About

This project is a Java-based UI automation framework that integrates with Appium and utilizes LLMs (like Claude) to drive intelligent test actions on mobile devices and simulators.

Details

Author: sycophant21
Downloads: 309
Categories: Developer Tools, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Promptium

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

From the repository

Install Appium (via npm) and Xcode on macOS, then configure Claude Desktop’s MCP settings by adding the Promptium JAR to claude_desktop_config.json. The JAR can be downloaded from GitHub releases or compiled locally with Maven (mvn package).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "promptium": {
            "promptium": {
                "command": "sh",
                "args": [
                    "-c",
                    "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
                ]
            }
        }
    }
}

McpServers

{
    "promptium": {
        "command": "sh",
        "args": [
            "-c",
            "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"
        ]
    }
}

Promptium

LLM-Driven UI Automation with Appium and MCP

This project is a Java-based UI automation framework that integrates with Appium and utilizes LLMs (like Claude)
to drive intelligent test actions on mobile devices and simulators.

Key Features

- UI Automation with Appium
Supports device interaction such as tap, swipe/scroll, and screenshot capture on both local simulators and
real/physical devices.

- LLM Integration for Intelligent Test Control
Leverages large language models (LLMs) to interpret natural-language instructions and drive UI behavior.

- Model Context Protocol (MCP) Server
Implements an MCP server to allow communication with Claude Desktop, enabling context-aware, language-driven test
flows.

- Java-Based Architecture
Built with Java for reliability, performance, and seamless integration with existing test ecosystems.

Technologies Used

- Java 23+ (Minimum Required Java 17)
- Appium
- MCP Protocol
- LLM (Claude Desktop integration)

Project Structure

src/
├── main/
│   └── java/
│       └── com/jadt/
│           ├── builder/       # Appium driver capabilities builder
│           ├── connector/     # Appium driver download, intiate and connection logic
│           └── domain/        # Domain Objects for images and page source
│           └── handler/       # Actions logic
│           └── util/          # Image (Screenshot) and Page Source utilities

Configration Steps (for macOS)

1. Install Homebrew
1. Install:
``/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    2. Add to System Path:

 

       echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile

       eval "$(/opt/homebrew/bin/brew shellenv)" 

       2. Install Node:

   
brew install node3. Install Appium

   
npm install -g appium4. Install XCode: 
xcode-select --install5. Carthage 
brew install carthage

 (Only for Physical iOS Devices)

6. Install XCUITest Plugin for appium

appium driver install xcuitest

iOS Device Access Requirements

1. Apple Hardware Required

2. You must have Xcode installed from the App Store on Mac.

3. Connect a real iOS device via USB or use a simulator.

4. Trust the developer certs on the device (if testing on real devices).

5. Enable Developer Mode on ios in System Settings > Privacy & Security > Developer Mode > On

6. Enable UI Automation on ios in System Settings > Developer > Enable UI Automation (Tap/Toggle to enable)
Claude Setup
1. Download Claude Desktop from https://claude.ai/download (Mcp not supported on claude web yet.)

2. Setup MCP -> Settings > Developer > Edit Config

3. Add the following code to 
claude_desktop_config.json

` under `mcpServers`

, if you want to use the offical release.

        {

      "promptium": {

        "command": "sh",

        "args": ["-c", "curl -sL https://github.com/sycophant21/promptium/releases/latest/download/Promptium_v0.0.1.jar -o /tmp/promptium-mcp-server.jar && java -jar /tmp/promptium-mcp-server.jar"]

      }

    }

    


4. Add the following code to

`claude_desktop_config.json` under `mcpServers`

, if you want to use your own compiled version.

       {

      "promptium": {

        "command": "java",

        "args": ["-jar", "Absolute-Path/to/your/compiled/jar"]

      }

    }

    


   Note: Jar can be compiled using java and maven, the instructions to create the jar are already written in the pom.xml file, just run

`mvn package`` in the project folder and you will find the jar inside "/target" folder. Use the shaded jar.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Promptium

LLM-Driven UI Automation with Appium and MCP

Key Features

Technologies Used

Project Structure

Configration Steps (for macOS)

iOS Device Access Requirements

Claude Setup

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel