HttpRunner
HttpRunner 是一款开源的 API/UI 测试框架，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。
What is HttpRunner?
HttpRunner is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to httprunner 是一款开源的 api/ui 测试框架，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。
HttpRunner 是一款开源的 API/UI 测试框架，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- HttpRunner 是一款开源的 API/UI 测试框架，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx httprunnerConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use HttpRunner
HttpRunner is an open-source API and UI testing framework written in Go that supports HTTP/S, HTTP2, WebSocket, and RPC protocols alongside mobile automation for Android (via adb/UIAutomator2) and iOS (via WebDriverAgent). It ships an MCP server mode via 'hrp mcp-server' that exposes its testing, device management, and automation capabilities to AI agents and LLM-powered tools, enabling natural-language-driven test execution and device interaction. QA engineers and developers use it to write once and run API tests, load tests, and UI automation across platforms with a plugin system for custom functions and CI/CD integration via JSON logs and HTML reports.
Prerequisites
- Go 1.19+ (if building from source) or a pre-built hrp binary
- For Android automation: adb installed and devices/emulators connected
- For iOS automation: WebDriverAgent (WDA) configured on the iOS device
- An MCP-compatible client such as Claude Desktop or a tool supporting mcphost
- Python virtual environment (optional, for running pytest-based tests via --venv)
Install the hrp binary
Download the pre-built hrp binary for your platform from the HttpRunner GitHub releases page, or install via Go. After installation, verify the setup with hrp -h.
# Via Go:
go install github.com/httprunner/httprunner/v4/cmd/hrp@latest
# Verify:
hrp -hRun a basic API test
HttpRunner test cases are defined in JSON or YAML. Run an existing test case with hrp run to verify the framework is working before setting up MCP.
hrp run path/to/testcase.json
# Or with pytest engine:
hrp pytest path/to/testcase.json
# Generate an HTML report:
hrp report --input results.json --output report.htmlConvert test formats
HttpRunner can convert test cases between formats, making it easy to migrate from other tools or generate Go/Python test code from JSON definitions.
hrp convert path/to/testcase.json --output-format gotest
hrp convert path/to/testcase.yaml --output-format pytestStart the MCP server
Launch HttpRunner's built-in MCP server to expose testing and automation tools to AI agents. The server listens on stdio by default for MCP client connections.
hrp mcp-server
# Or start an interactive chat session with MCP tools:
hrp mcphostConfigure as an MCP server for AI clients
Add HttpRunner's MCP server to your MCP client configuration. The server requires the hrp binary to be in PATH or specified with a full path.
{
"mcpServers": {
"httprunner": {
"command": "hrp",
"args": ["mcp-server"],
"env": {}
}
}
}HttpRunner Examples
Client configuration
MCP client configuration for Claude Desktop to use HttpRunner's MCP server for API testing and device automation.
{
"mcpServers": {
"httprunner": {
"command": "hrp",
"args": ["mcp-server"],
"env": {}
}
}
}Prompts to try
Example prompts to use with HttpRunner via an MCP-enabled AI assistant.
- "Run the API test suite at testcases/login.json and summarize the results"
- "List connected Android devices and check their status"
- "Convert the test case in YAML format to a Go test file"
- "Execute a load test with 50 concurrent users against https://api.example.com/users"
- "Generate an HTML report from the last test run results"Troubleshooting HttpRunner
hrp: command not found after Go install
Go binaries are installed to $(go env GOPATH)/bin. Add this to your PATH with: export PATH="$PATH:$(go env GOPATH)/bin" — then add this line to your ~/.zshrc or ~/.bashrc for persistence. Run 'go env GOPATH' to find the exact path on your system.
Android device not detected by hrp adb commands
Ensure adb is installed ('adb version') and the device is connected with USB debugging enabled. Run 'adb devices' to list connected devices. If the device shows as 'unauthorized', accept the debugging prompt on the device screen.
hrp mcp-server starts but AI client cannot connect
Verify the hrp binary path is correct in your MCP config — use the full path from 'which hrp' if the binary is not in the system PATH seen by the MCP client. On macOS, GUI apps may have a different PATH than the terminal; use absolute paths in the args array.
Frequently Asked Questions about HttpRunner
What is HttpRunner?
HttpRunner is a Model Context Protocol (MCP) server that httprunner 是一款开源的 api/ui 测试框架，简单易用，功能强大，具有丰富的插件化机制和高度的可扩展能力。 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install HttpRunner?
Follow the installation instructions on the HttpRunner GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with HttpRunner?
HttpRunner works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is HttpRunner free to use?
Yes, HttpRunner is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
HttpRunner Alternatives — Similar Developer Tools Servers
Looking for alternatives to HttpRunner? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up HttpRunner in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use HttpRunner?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.