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 分