Davflare skill

A skill that teaches agents to use a personal Cloudflare R2 drive over MCP: files, share links, static sites and images.

  • 105 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The API key lets the agent read and write drive files, including deletion.
  • Publishing sites and images exposes files at public links.
All reasons and checks

fanchenggang/davflare

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/davflare

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The API key lets the agent read and write drive files, including deletion.
  • Publishing sites and images exposes files at public links.

This is third-party code. Review the repository files before installing.

What it does

Davflare is a file manager on Cloudflare Pages and R2 with 10 GB of free storage and 100,000 invocations a day. One deployment gives a web UI, WebDAV, an `/mcp` endpoint with about 25 tools and a key-based API. The official `davflare` skill explains to the agent how to use that drive and forbids inventing calls that do not exist. The agent uploads, downloads, searches, copies and moves files, creates share links with expiry and a code, manages the trash, publishes a folder as a static site with `publish_site` and uploads pictures to an image host. The `agents/` layer on R2 stores skills, rules and MCP settings for Cursor, Claude, Codex and OpenCode, and the `pull` and `push` tools sync it across machines.

Who it is for. Developers who deployed Davflare on their own Cloudflare and want to manage the drive, sites and images from Cursor, Claude Code or Codex.

Good fit when

  • The agent must publish a built folder as a static site on your own subdomain.
  • Screenshots for Markdown are uploaded to an image host and returned as public links.
  • A file goes to a client through a link with an expiry and an access code.
  • Agent skills and rules are stored on R2 and moved between computers.

Not a fit when

  • There is no Cloudflare account with R2 enabled and a card on file; deployment fails without it.
  • A ready-made drive without deployment is needed; Davflare is set up in your own account.
  • Files exceed 100 MB; Cloudflare stops a request of that size.

Example request

Publish the `examples/hello-site` folder from the drive as a site with the slug `hello` and show the address.

Limitations

The skill works only against a deployed Davflare instance. It needs a Cloudflare account with R2 enabled and a card on file, plus an API key like `fd_…` that is shown once. The key is supplied through `DAVFLARE_API_KEY` rather than written into files. If the API Key switch is off, `/mcp` answers 404 even with MCP on. A file uploads over MCP up to 25 MB, and larger ones go through the web UI or `davflare-cli`. Public sites and images need `SITES_HOST` on a separate hostname.

How to disable. Remove the skill folder from the agent skills directory (for Cursor `~/.cursor/skills/davflare/`), the `davflare` block from `mcp.json` and the `DAVFLARE_API_KEY` variable. Revoke the key in the drive settings. Delete the Cloudflare Pages project and R2 contents separately.

FAQ

How do I connect MCP?

In the drive settings create an API key, keep API Key and MCP on and copy the config from the export card. Cursor needs an `mcp.json` with `url` and an `Authorization: Bearer ${env:DAVFLARE_API_KEY}` header. Claude Desktop connects through the `mcp-remote` bridge.

How does the skill differ from the MCP export?

The export only creates `mcp.json`. The skill explains to the agent which tools to use and in what order once connected.

How do I publish a site?

Turn Sites on, set `SITES_HOST` (hostname only) and redeploy. Upload content into a drive folder and call `publish_site` with a slug and a path. The site opens at `https://<SITES_HOST>/<slug>/`.

Is there a command line?

Yes, the repository includes `davflare-cli`: it needs Node.js 18 or newer and creates a dedicated API key at login with `davflare login --server`.

Where are agent skills stored?

In `agents/` on R2 in layers: global, agent and project. On merge the project wins, then the agent, then the global layer. The `pull` and `push` tools walk the whole tree.

Discussion

No questions or reviews yet.

Skills
Official

Serverless notes on Cloudflare Workers with an MCP endpoint and a skill so agents can search and write your notes

MCP serverBroad access356Repository stars

A self-hosted issue tracker and wiki on Cloudflare with MCP: 126 tools, issue leases and file claims for several agents

MCP serverBroad access66Repository stars
Russian stack

Yandex Disk MCP server: folders, metadata, copy, move, delete and upload or download links

MCP serverBroad access4Repository stars

A self-hosted scheduler on Cloudflare Workers with a built-in MCP server: an agent lists slots, creates and reschedules bookings

MCP serverExtended access129Repository stars

Glance publishes an agent's pages to your Cloudflare, collects browser comments and hands them back to the agent to fix.

CLIExtended access56Repository stars

README in short

The repository ships ready examples: site publishing, MCP export, phone upload, an image host for ShareX and Typora, and cron backups. The drive speaks WebDAV class 1 and 2, for example for Obsidian sync.

README badge

Report a problem