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 文件。