Hoverfly MCP Server
About
An MCP server exposing Hoverfly as a programmable API simulation tool for AI assistants.
Details
- Author
- kapishmalik
- Categories
- Developer Tools, API
Jump to
Setup
Install Hoverfly MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/kapishmalik/hoverfly-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
ASpring Boot-basedModel Context Protocol (MCP)server that exposesHoverflyas a programmable tool for AI assistants likeCursor,Claude Desktop,GitHub Copilot, or any other assistant supporting MCP. It enables dynamic mocking of third-party APIs to unblock development and testing when external services are unavailable.
Note:The following prerequisites and build steps are only required if you want to contribute or build from source. For most users, using the Docker image is sufficient.
git clone <repository-url> cd hoverfly-mcp-server mvn clean package java -jar target/hoverfly-mcp-server-<version>.jar
Replace<version>with the actual version of the JAR you built.
⚙️ Configuring as an MCP Server (with Docker)
To use this server with an AI assistant that supports Model Context Protocol (MCP), add the following to your.mcp.jsonormcp.config.json:
{ "mcpServers": { "hoverfly-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-p 8500:8500", "-p 8888:8888", "-v /path/to/your/data:/opt/hoverfly-mcp/simulation-data", "docker.io/kapish88/hoverfly-mcp-server" ] } } }
- 8500: Hoverfly proxy port (mocked services)
- 8888: Hoverfly admin port (mock control API)
- -v /path/to/your/data:/opt/hoverfly-mcp/simulation-data: Mount a volume for simulation persistence
Make sure Docker is installed. The image will be pulled automatically if not available locally.
These tools can be invoked programmatically by AI assistants through the AI Assistant host.
The server supports simulation persistence through a fixed, mounted volume:
When starting Hoverfly withstart_hoverfly_web_server, the server will by default:
- Load the most recent simulation file from/opt/hoverfly-mcp/simulation-data(if available)
- Start with a clean state if no simulation file is found
You can disable auto-load by setting the appropriate parameter.
To persist simulation data across restarts, youmustmount a host directory to/opt/hoverfly-mcp/simulation-datainside the container.
This is the only supported location for persistent data.
Note:The host directory must be writable by the container user.
Simulation files are only saved to this directory when you explicitly invoke the download tool.
- Fork this repo
- Create a feature branch
- Submit a Pull Request
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
An MCP server for interacting with the Postman API, requiring an API key.
Adds possibility to work with testing management via MCP
An enhanced Apifox MCP service providing comprehensive API management capabilities for Claude Desktop and Cursor.
This MCP Server accepts swagger/postman documents as input. It then generates API & Load test scenarios, executes the tests and generates the execution report.
A Model Context Protocol (MCP) server for creating, managing, and executing Bruno API testing collections. Supports both .bru and .yml (opencollection) formats with built-in security hardening.
Execute Bruno collections using the Bruno CLI, with support for environment files and detailed test results.
A free public REST API for testing and prototyping, powered by JSONPlaceholder.
Postman for MCP — search 156 servers, inspect tools with schema visualizer, test live
An AI-native API testing platform for generating scenarios, executing tests, and analyzing results.
An MCP server and client implementation for the Swagger Petstore API.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





