HTTrack MCP Server

io.github.TechVentures-Studiov1.0.1更新於 Oct 1, 2026

AI-agent website mirroring and offline archive browsing over MCP, powered by HTTrack.

已驗證STDIO僅桌面Files & StorageWeb Search & Scraping

概覽

AI 產生的概覽

封裝 HTTrack，讓助理能把網站鏡像到本機封存，並瀏覽、讀取與搜尋已下載的檔案。

功能
此伺服器把 HTTrack 的網站複製能力以 MCP 工具的形式提供。助理可用 mirror_site 啟動背景鏡像，用 mirror_status 查詢進度，再以 catalog、list_files、read_file 和 search_files 處理封存內容。鏡像依專案存放在共用封存目錄下，文字檔案可讀取或依子字串搜尋。
適用情境
當助理需要網站的離線副本，以便日後閱讀、搜尋或據此回答問題時使用，而非即時抓取。適合需要反覆查詢同一批已下載內容的研究或文件封存情境。
執行需求
以本機行程執行；文件中的部署方式使用 Docker，容器透過對應連接埠以 streamable HTTP 暴露 MCP 伺服器。需要把一個主機目錄以讀寫方式掛載為封存目錄。未宣告任何身分驗證。
安裝前請注意
README 說明沒有任何身分驗證，因此只應在可信任網路中執行，或置於具備驗證的閘道之後。鏡像會把第三方網站內容下載到掛載的封存目錄，且該磁碟區以讀寫方式掛載。read_file 會拒絕二進位檔案，並將內容限制在 256 KB。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 HTTrack MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

HTTrack MCP Server

[License: AGPL v3]

A FastMCP (Model Context Protocol) server that wraps the classic HTTrack website copier, so AI agents can mirror websites into a shared archive and then browse, read, and search the downloaded content — all over MCP.

Copyright (C) 2026 Tech Ventures VCC. Licensed under the GNU Affero General Public License v3.0 (see LICENSE).

Why

HTTrack is battle-tested for offline website copying, but it has no scripting API — only a GUI and a CLI. This server makes it agent-native: an LLM agent can call mirror_site to start a download in the background, poll mirror_status, and later answer questions from the archive via catalog, list_files, read_file, and search_files.

Tools

ToolPurpose
mirror_site(url, project, depth, max_rate, filters)Start a background mirror into the archive (/data/<project>). One active mirror per project — a concurrent request for the same project returns already_running with the live job_id; different projects run in parallel.
mirror_status(job_id)Job status (running / done / failed + log tail). Omit to list recent jobs; also accepts the project name.
catalog()All projects: short name, short description (auto-derived from each site's <title>/meta description), source URL, status, page/file counts, size.
list_files(project, subpath)Directory listing inside a project (name, type, size, modified).
read_file(project, path, max_bytes)Read one text file (HTML/JS/CSS/txt/json/md). Refuses binaries; caps content at 256 KB to keep agent context sane.
search_files(project, query, max_results)Case-insensitive substring search across a project's text files, capped results.

Quick start

Prerequisites: Docker.

bash
docker build -t httrack-mcp-server .
docker run -d --name httrack-mcp --restart unless-stopped \  -p 9050:8000 \  -v /path/to/your/archive:/data:rw \  httrack-mcp

The container exposes the MCP server over streamable HTTP at http://<host>:9050/mcp.

Register in an MCP client

Example for MCPHub-style gateways (streamable-http):

json
{  "httrack": {    "type": "streamable-http",    "url": "http://192.168.1.35:9050/mcp",    "enabled": true,    "description": "HTTrack site mirroring + archive browsing",    "owner": "admin"  }}

Clients that speak streamable HTTP directly can connect to /mcp with no extra auth (nobody is authenticated; run this on a trusted network, or put it behind your gateway's auth). See HELP.md for full usage, examples, and troubleshooting.

Concurrency model

  • One httrack process per project, isolated by its own output directory — no shared state between projects, so multiple agents can mirror different sites in parallel.
  • mirror_site guards against double-mirroring the same project (in-process job table + a /proc scan for httrack processes writing to that project directory).

CI

GitHub Actions runs on every PR and push: Python syntax check of server.py, Dockerfile sanity assertions, and a Docker image build.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

If you run a modified version of this server as a network service, AGPL §13 requires you to offer your users the corresponding source of that modified version.

Copyright (C) 2026 Tech Ventures VCC. HTTrack itself is GPL-licensed by Xavier Roche and contributors; this project only shells out to it and is not affiliated with it.

來源：README.md，提交 7feccd3

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.1最新Oct 1, 2026