Promptium

@sycophant21

About Promptium

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.

#java #llm #mcp-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Promptium?

Promptium is a Java-based UI automation framework that integrates with Appium and uses large language models (like Claude) to drive intelligent test actions on mobile devices and simulators. It implements a Model Context Protocol (MCP) server for context-aware, language-driven test flows.

How to use Promptium?

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).

Key features of Promptium

UI Automation with Appium (tap, swipe/scroll, screenshot)
LLM integration for intelligent test control
MCP server for communication with Claude Desktop
Java-based architecture (requires Java 17+)

Use cases of Promptium

Automating UI tests on iOS simulators and real devices
Executing test flows using natural-language instructions via Claude
Integrating with existing Java test ecosystems

FAQ from Promptium

What are the system requirements?

Java 17 or higher, macOS with Xcode installed, Node.js, and Appium. For physical iOS devices, Carthage and developer-mode configuration are also required.

How do I configure Promptium with Claude Desktop?

In Claude Desktop, go to Settings > Developer > Edit Config, then add a promptium entry to mcpServers in claude_desktop_config.json with the command to run the JAR (either from a downloaded release or a local build).

Does Promptium support Android?

No. The README only describes iOS device/simulator setup using Appium’s XCUITest driver.

Is a physical Apple device required?

A physical device is only needed for testing on real iOS hardware; testing can also be done using an iOS simulator.

How is the MCP server started?

The server starts automatically when Claude Desktop invokes the configured command (java -jar ...). It can also be run manually via the command line by executing the compiled JAR.

Frequently asked questions

What are the system requirements?

Java 17 or higher, macOS with Xcode installed, Node.js, and Appium. For physical iOS devices, Carthage and developer-mode configuration are also required.

How do I configure Promptium with Claude Desktop?

In Claude Desktop, go to Settings > Developer > Edit Config, then add a `promptium` entry to `mcpServers` in `claude_desktop_config.json` with the command to run the JAR (either from a downloaded release or a local build).

Does Promptium support Android?

No. The README only describes iOS device/simulator setup using Appium’s XCUITest driver.

Is a physical Apple device required?

A physical device is only needed for testing on real iOS hardware; testing can also be done using an iOS simulator.

How is the MCP server started?

The server starts automatically when Claude Desktop invokes the configured command (`java -jar ...`). It can also be run manually via the command line by executing the compiled JAR.

Comments

Basic information

More Developer Tools MCP servers

MCP Containers

metorial

Connect any AI model to 1200+ integrations (MCP, CLI, API)

3.3K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K