hoverfly-mcp-server

kapishmalik/hoverfly-mcp-server

3.4

If you are the rightful owner of hoverfly-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Hoverfly MCP Server is a Spring Boot-based server that exposes Hoverfly as a programmable tool for AI assistants, enabling dynamic mocking of third-party APIs.

Hoverfly MCP Server is a robust solution designed to facilitate the development and testing of applications by providing a programmable interface for AI assistants to interact with Hoverfly. Built on Spring Boot, this server leverages the Model Context Protocol (MCP) to enable AI tools like Cursor, Claude Desktop, and GitHub Copilot to dynamically mock third-party APIs. This capability is particularly useful when external services are unavailable, allowing developers to continue their work without interruption. The server supports simulation persistence, ensuring that mock data can be retained across sessions, and offers a suite of tools for managing Hoverfly's operations programmatically. By integrating with Docker, the server can be easily deployed and managed, making it a versatile addition to any development environment.

Features

  • Spring Boot-based server for easy integration
  • Supports Model Context Protocol (MCP) for AI assistant interaction
  • Enables dynamic mocking of third-party APIs
  • Simulation persistence through Docker volume mounting
  • Comprehensive toolset for managing Hoverfly operations

Usages

docker with AI assistant

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

Tools

  1. get_hoverfly_status

    Checks if Hoverfly is running

  2. start_hoverfly_web_server

    Starts Hoverfly in simulate mode as a web server

  3. stop_hoverfly_server

    Stops Hoverfly and clears mocks

  4. fetch_hoverfly_version

    Returns Hoverfly version

  5. list_hoverfly_mocks

    Lists all active mock APIs