HttpRunner UIXT MCP Server

Content

HttpRunner UIXT MCP Server exposes HttpRunner's UIXT automation layer through a stdio MCP server. It gives Claude and other MCP clients structured tools for discovering devices, selecting a test target, tapping, swiping, entering text, controlling apps, capturing screen state, and running browser actions.

Use it when Claude needs supervised access to a prepared UI testing environment, not when an assistant should freely control a personal phone, desktop browser, or production account.

Source Review

• https://github.com/httprunner/httprunner
• https://raw.githubusercontent.com/httprunner/httprunner/master/docs/uixt/mcp-server.md
• https://raw.githubusercontent.com/httprunner/httprunner/master/LICENSE
• https://raw.githubusercontent.com/httprunner/httprunner/master/README.md
• https://raw.githubusercontent.com/httprunner/httprunner/master/go.mod
• https://raw.githubusercontent.com/httprunner/httprunner/master/cmd/cli/main.go
• https://raw.githubusercontent.com/httprunner/httprunner/master/cmd/mcpserver.go
• https://raw.githubusercontent.com/httprunner/httprunner/master/uixt/mcp_server.go
• https://raw.githubusercontent.com/httprunner/httprunner/master/docs/cmd/hrp_mcp-server.md
• https://raw.githubusercontent.com/httprunner/httprunner/master/docs/uixt/mcp-tools.md

These sources were reviewed on 2026-06-06. Prefer the live repository, MCP server docs, license, README, Go module, CLI entrypoint, MCP command source, UIXT server source, Cobra command docs, and tool documentation for current setup and behavior details.

Features

• Start a stdio MCP server with hrp mcp-server.
• Discover and select Android, iOS, Harmony, simulator, or browser targets.
• Tap by relative coordinates, absolute coordinates, OCR text, computer vision, or selectors.
• Swipe, drag, double tap, press buttons, go home, and go back.
• Enter text, set input method behavior, and use simulated input actions.
• Launch, terminate, cold launch, install, uninstall, clear, and inspect apps.
• Capture screenshots, screen recordings, screen size, and UI hierarchy/source.
• Run browser actions such as selector hover, selector tap, secondary click, and closing tabs.
• Use higher-level AI action and start-to-goal workflows when the target environment is approved for autonomous testing.

Installation

The current MCP server is part of HttpRunner v5 source. Build the CLI from the repository:

git clone https://github.com/httprunner/httprunner.git
cd httprunner
go build -o hrp ./cmd/cli

Then configure your MCP client to launch the hrp mcp-server command:

{
  "mcpServers": {
    "httprunner-uixt": {
      "command": "hrp",
      "args": ["mcp-server"]
    }
  }
}

Make sure the built hrp binary is on PATH for the MCP client process, or use the full path to the binary in your local configuration.

Use Cases

• Let Claude inspect connected test devices before choosing a target.
• Reproduce a mobile UI bug through controlled taps, swipes, and screenshots.
• Launch a test app, clear state, and capture the resulting UI hierarchy.
• Automate a browser flow using selectors and screenshots in a supervised test session.
• Generate exploratory UI actions against a simulator, then convert stable steps into repeatable HttpRunner test assets.

Safety and Privacy

HttpRunner UIXT MCP Server is powerful device automation. Use it only with authorized test devices, simulators, or browsers. Keep production accounts, personal devices, payment flows, device settings, and customer data outside the agent-controlled environment unless the task has explicit approval and rollback coverage.

Review screenshots, recordings, package lists, UI hierarchy output, OCR text, selector data, and logs before sharing them. Reset devices or simulators between runs when tests may expose credentials, private messages, or internal app state.