Hoverfly MCP Server

🚀 Hoverfly MCP Server

Hoverfly MCP Server 是一个基于 Spring Boot 的 模型上下文协议（MCP） 服务器，它将 Hoverfly 作为可编程工具，供 Cursor、Claude Desktop、GitHub Copilot 等 AI 助手或任何支持 MCP 的助手使用。当外部服务不可用时，它能够对第三方 API 进行动态模拟，从而推动开发和测试工作的进行。

🚀 快速开始

本项目是一个基于 Spring Boot 的 MCP 服务器，借助它可让 AI 助手使用 Hoverfly 进行第三方 API 的动态模拟。以下是使用该项目的相关步骤。

📦 安装指南

注意：以下的先决条件和构建步骤仅在你想要贡献代码或从源代码进行构建时才需要。对于大多数用户来说，使用 Docker 镜像就足够了。

先决条件

• Java 17
• Maven 3.6+

构建与运行

git clone <repository-url>
cd hoverfly-mcp-server
mvn clean package
java -jar target/hoverfly-mcp-server-<version>.jar

请将 <version> 替换为你构建的 JAR 文件的实际版本。

⚙️ 配置为 MCP 服务器（使用 Docker）

要将此服务器与支持模型上下文协议（MCP）的 AI 助手一起使用，请在你的 .mcp.json 或 mcp.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 代理端口（模拟服务）
• 8888：Hoverfly 管理端口（模拟控制 API）
• -v /path/to/your/data:/opt/hoverfly-mcp/simulation-data：挂载一个卷以实现模拟数据的持久化

请确保已安装 Docker。如果本地没有该镜像，它将自动拉取。

🔧 暴露的 MCP 工具

这些工具可以由 AI 助手通过 AI 助手主机以编程方式调用。

💾 模拟数据持久化

服务器通过固定的挂载卷支持模拟数据的持久化：

启动时自动加载

使用 start_hoverfly_web_server 启动 Hoverfly 时，服务器默认会：

• 从 /opt/hoverfly-mcp/simulation-data 加载最新的模拟文件（如果可用）
• 如果未找到模拟文件，则以干净的状态启动

你可以通过设置相应的参数来禁用自动加载。

持久化数据和卷挂载

为了在重启时保留模拟数据，你 必须 将主机目录挂载到容器内的 /opt/hoverfly-mcp/simulation-data。
这是唯一支持持久化数据的位置。

注意：主机目录必须对容器用户可写。

只有在你显式调用下载工具时，模拟文件才会保存到该目录。

🤝 贡献代码

1. 分叉此仓库
2. 创建一个功能分支
3. 提交拉取请求

📄 许可证

有关许可条款，请参阅 LICENSE 文件。