WebDAV MCP

io.github.vernonstinebaker由 GitHub 帳號 vernonstinebaker 發布v1.1.1更新於 Oct 24, 2026

Zero-dependency WebDAV MCP server — single static binary, no Node.js or Python. 8 tools via stdio.

概覽

AI 產生的概覽

一個零依賴的 WebDAV MCP 伺服器,以單一靜態二進位檔提供,讓助理在 WebDAV 伺服器上列出、讀取、寫入、移動、複製和刪除檔案

可以做什麼
列出指定路徑下的檔案和目錄(可選遞迴),並透過 stat 取得單一檔案或目錄的中繼資料(大小、修改時間、etag、類型)。以文字形式讀取檔案內容,可設定最大讀取位元組數。寫入、建立或覆寫檔案,可指定 MIME 類型,並可選擇自動建立缺少的父目錄。建立目錄、移動或重新命名檔案與目錄、複製檔案與目錄,以及刪除檔案或目錄。
適用情境
適合助理需要操作既有 WebDAV 伺服器上的檔案時使用,例如自架 NAS、類似 Nextcloud 的共享或內部檔案服務,且不想安裝 Node.js 或 Python 執行環境。適合偏好小型靜態二進位檔的桌面環境。
執行需求
作為本機程序透過 stdio 在桌面平台執行;提供 macOS(Apple Silicon 與 Intel)和 Linux(x86-64、ARM64、ARMv7)的預先編譯二進位檔。需要可存取的 WebDAV 伺服器,以及環境變數 WEBDAV_URL(必填)、WEBDAV_USER 和 WEBDAV_PASS。從原始碼建置需要 Zig 0.16.0。
安裝前請注意
伺服器透過 WEBDAV_PASS 保存 WebDAV 憑證,並以 HTTP Basic 驗證傳送,建議使用 HTTPS 或可信網路。相關工具可寫入、覆寫、移動、複製和刪除遠端伺服器上的檔案與目錄,包括遞迴操作;允許前請審查破壞性呼叫。部分伺服器可能禁止遞迴列出。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

webdav-mcp

A zero-dependency WebDAV MCP server — single static binary, no Node.js or Python required.

Implements the Model Context Protocol (MCP) over JSON-RPC 2.0 via stdio, exposing 8 WebDAV operations as tools that any MCP-compatible AI agent can call.

Why this exists

Every other WebDAV MCP server on GitHub requires a Node.js or Python runtime. This one is a single self-contained binary (~100–160 KB) compiled from Zig. It runs anywhere without installing a runtime, and it cross-compiles to all major platforms from one machine.

Tools

ToolDescription
listList files and directories at a path
readRead file contents as text
writeWrite (create or overwrite) a file
deleteDelete a file or directory
mkdirCreate a directory
moveMove or rename a file or directory
copyCopy a file or directory (sends Depth: infinity per RFC 4918 §9.8.2)
statGet metadata for a single file or directory (PROPFIND Depth:0)

Tool parameters

list

  • path (required) — directory path relative to WebDAV root
  • recursive (boolean, default false) — if true, lists recursively using Depth: infinity. Note: some servers (IIS, some nginx configs) block recursive listing.

read

  • path (required) — file path relative to WebDAV root
  • max_bytes (integer, default 1048576) — maximum file size to read in bytes. Returns an error if the file is larger. Increase this for large files.

write

  • path (required) — file path relative to WebDAV root
  • content (required) — content to write
  • content_type (string, default application/octet-stream) — MIME type for the file (e.g. text/plain, application/json)
  • create_parents (boolean, default false) — if true and the parent directory does not exist, automatically creates all missing ancestor directories via MKCOL before writing

stat

  • path (required) — path to stat relative to WebDAV root
  • Returns: file or dir or missing, plus size=, modified=, etag=, and type= when available

Configuration

Set these environment variables before launching the server:

VariableDescriptionExample
WEBDAV_URLBase URL of the WebDAV serverhttp://192.168.1.10:8080
WEBDAV_USERUsernameadmin
WEBDAV_PASSPasswordsecret

Credential security

Credentials are sent via native Zig HTTP networking using the Authorization: Basic ... header. No external curl process is spawned.

Building from source

Requires Zig 0.16.0.

bash
# Development buildzig build
# Optimized release build (~100-160 KB)zig build -Doptimize=ReleaseSmall
# Cross-compile for all platforms (outputs to zig-out/release/)zig build cross

Cross-compilation targets

FilePlatform
webdav-mcp-macos-arm64macOS Apple Silicon
webdav-mcp-macos-x86_64macOS Intel
webdav-mcp-linux-arm64Linux ARM64 (static musl)
webdav-mcp-linux-x86_64Linux x86-64 (static musl)
webdav-mcp-linux-armv7Linux ARMv7 / Raspberry Pi (static musl)
webdav-mcp-windows-x86_64.exeWindows x86-64

Integration with nullclaw / *Claw bots

Add an mcp_servers entry to your bot's config.json:

json
{  "mcp_servers": {    "webdav": {      "command": "/path/to/webdav-mcp",      "args": [],      "env": {        "WEBDAV_URL": "http://your-webdav-server:8080",        "WEBDAV_USER": "your-username",        "WEBDAV_PASS": "your-password"      }    }  }}

The server speaks JSON-RPC 2.0 over stdio (newline-delimited), which is the standard MCP transport. Once registered, the agent can call all 8 tools as normal tool calls.

Running tests

bash
zig build test --summary all

All unit tests cover XML parsing, JSON-RPC dispatch, argument extraction, URL construction, percent-encoding, entity decoding, and HTTP method routing.

License

MIT — see LICENSE.

來源:README.md,提交 fd45113

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分