WebDAV MCP

webdav-mcp

零依赖的 WebDAV MCP 服务——单个静态二进制文件，无需 Node.js 或 Python。

通过标准输入/输出使用 JSON-RPC 2.0 实现 Model Context Protocol（MCP），并将 8 种 WebDAV 操作作为工具公开，供任何兼容 MCP 的 AI Agent 调用。

为什么开发这个项目

GitHub 上其他所有 WebDAV MCP 服务都需要 Node.js 或 Python 运行时。这个服务是一个独立的二进制文件（约 100–160 KB），由 Zig 编译而成。它无需安装运行时即可在任何地方运行，并且可以在一台机器上交叉编译到所有主流平台。

工具

工具	说明
list	列出指定路径下的文件和目录
read	以文本形式读取文件内容
write	写入（创建或覆盖）文件
delete	删除文件或目录
mkdir	创建目录
move	移动或重命名文件或目录
copy	复制文件或目录（根据 RFC 4918 §9.8.2 发送 Depth: infinity）
stat	获取单个文件或目录的元数据（PROPFIND Depth:0）

工具参数

list

• path（必填）——相对于 WebDAV 根目录的目录路径
• recursive（布尔值，默认 false）——若为 true，则使用 Depth: infinity 递归列出内容。注意：某些服务端（IIS、某些 nginx 配置）会阻止递归列出。

read

• path（必填）——相对于 WebDAV 根目录的文件路径
• max_bytes（整数，默认 1048576）——要读取的最大文件大小（字节）。若文件更大，则返回错误。读取大文件时请增大此值。

write

• path（必填）——相对于 WebDAV 根目录的文件路径
• content（必填）——要写入的内容
• content_type（字符串，默认 application/octet-stream）——文件的 MIME 类型（例如 text/plain、application/json）
• create_parents（布尔值，默认 false）——若为 true 且父目录不存在，则在写入前通过 MKCOL 自动创建所有缺失的上级目录

stat

• path（必填）——相对于 WebDAV 根目录的待查询路径
• 返回：file、dir 或 missing，以及可用时的 size=、modified=、etag= 和 type=

配置

启动服务前设置以下环境变量：

变量	说明	示例
WEBDAV_URL	WebDAV 服务的基础 URL	http://192.168.1.10:8080
WEBDAV_USER	用户名	admin
WEBDAV_PASS	密码	secret

凭据安全

凭据通过 Zig 原生 HTTP 网络功能使用 Authorization: Basic ... 标头发送。不会启动外部 curl 进程。

从源代码构建

需要 Zig 0.16.0。

# Development build
zig build

# Optimized release build (~100-160 KB)
zig build -Doptimize=ReleaseSmall

# Cross-compile for all platforms (outputs to zig-out/release/)
zig build cross

交叉编译目标

文件	平台
webdav-mcp-macos-arm64	macOS Apple Silicon
webdav-mcp-macos-x86_64	macOS Intel
webdav-mcp-linux-arm64	Linux ARM64（静态 musl）
webdav-mcp-linux-x86_64	Linux x86-64（静态 musl）
webdav-mcp-linux-armv7	Linux ARMv7 / Raspberry Pi（静态 musl）
webdav-mcp-windows-x86_64.exe	Windows x86-64

与 nullclaw / *Claw 机器人集成

在机器人的 config.json 中添加一项 mcp_servers：

{
  "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"
      }
    }
  }
}

服务通过标准输入/输出使用 JSON-RPC 2.0 通信（以换行符分隔），这是标准的 MCP 传输方式。注册后，Agent 即可像调用普通工具一样调用全部 8 种工具。

运行测试

zig build test --summary all

所有单元测试涵盖 XML 解析、JSON-RPC 分发、参数提取、URL 构造、百分号编码、实体解码和 HTTP 方法路由。

许可证

MIT——参见 LICENSE。