Promptium

Name: Promptium
Author: sycophant21

本地服务

github.com/sycophant21开发工具280 周前更新

代码仓库

关于 Promptium

Promptium 是基于 Java 和 Appium 的移动端 UI 自动化框架，面向需要用自然语言驱动设备测试的开发者。它通过 LLM 解读指令，并提供 MCP 服务供 Claude Desktop 连接。

主要功能

01Appium 设备交互与 UI 自动化
02支持模拟器和真实设备
03LLM 解读自然语言测试指令
04提供 MCP 服务连接 Claude Desktop

适用场景

01通过自然语言执行移动端测试操作
02在模拟器或真实设备上截图、点击和滑动

MCP 相关

Promptium 实现 MCP 服务，允许 Claude Desktop 连接并驱动基于自然语言的测试流程。

#java #llm #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Promptium

使用 Appium 和 MCP 实现由大模型驱动的 UI 自动化

本项目是一个基于 Java 的 UI 自动化框架，集成了 Appium，并利用大模型（如 Claude） 在移动设备和模拟器上执行智能测试操作。

主要功能

使用 Appium 实现 UI 自动化
支持在本地模拟器和真实／物理设备上进行点击、滑动／滚动和截图等设备交互。
集成大模型，实现智能测试控制
利用大语言模型（LLM）解读自然语言指令并驱动 UI 行为。
模型上下文协议（MCP）服务
实现 MCP 服务以支持与 Claude Desktop 通信，从而实现具备上下文感知能力、由自然语言驱动的测试流程。
基于 Java 的架构
使用 Java 构建，具备可靠性和高性能，并可与现有测试生态系统无缝集成。

使用的技术

Java 23+（最低要求 Java 17）
Appium
MCP 协议
LLM（Claude Desktop 集成）

项目结构

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

配置步骤（适用于 macOS）

安装 Homebrew
1. 安装： /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 添加到系统路径：
```
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)" 
```
安装 Node： brew install node
Install Appium npm install -g appium
Install XCode: xcode-select --install
Carthage brew install carthage (Only for Physical iOS Devices)
Install XCUITest Plugin for appium appium driver install xcuitest

iOS Device Access Requirements

Apple Hardware Required
You must have Xcode installed from the App Store on Mac.
Connect a real iOS device via USB or use a simulator.
Trust the developer certs on the device (if testing on real devices).
Enable Developer Mode on ios in System Settings > Privacy & Security > Developer Mode > On
Enable UI Automation on ios in System Settings > Developer > Enable UI Automation (Tap/Toggle to enable)

Claude Setup

Download Claude Desktop from https://claude.ai/download (Mcp not supported on claude web yet.)
Setup MCP -> Settings > Developer > Edit Config

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

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.