Hoverfly MCP Server

by kapishmalik

Not rated
GitHub

About

An MCP server exposing Hoverfly as a programmable API simulation tool for AI assistants.

Details

Author
kapishmalik
Categories
Developer Tools, API

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.