Promptium

Name: Promptium
Author: sycophant21

@sycophant21

关于 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

基本信息

分类

开发工具

运行时

java

传输方式

stdio

发布者

sycophant21

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.