Ffl Mcp – Give Ai A "send File" Capability Via P2p (local First)

Download and runffl-mcp-setup.exefrom the latest release.

curl -fsSL https://raw.githubusercontent.com/nuwainfo/ffl-mcp/refs/heads/main/install.sh | bash

iwr -useb https://raw.githubusercontent.com/nuwainfo/ffl-mcp/refs/heads/main/install.ps1 | iex

uvx --from git+https://github.com/nuwainfo/ffl-mcp install

uvx --from git+https://github.com/nuwainfo/ffl-mcp install --target claude-desktop,codex-desktop,codex-cli

uvx --from git+https://github.com/nuwainfo/ffl-mcp install --print

uvx --from git+https://github.com/nuwainfo/ffl-mcp install --config /path/to/claude_desktop_config.json uvx --from git+https://github.com/nuwainfo/ffl-mcp install --codex-config /path/to/codex/config.toml

# optional: override embedded ffl.com (APE) or use "ffl" on PATH export FFL_BIN="$HOME/bin/ffl.com" chmod +x "$FFL_BIN" # optional safety: restrict file sharing to a directory export ALLOWED_BASE_DIR="$HOME/Downloads" # optional: use stdin for text/base64 instead of temp files export FFL_USE_STDIN=1 uvx --from git+https://github.com/nuwainfo/ffl-mcp ffl-mcp

{ "mcpServers": { "ffl": { "command": "uvx", "args": ["--from", "git+https://github.com/nuwainfo/ffl-mcp", "ffl-mcp"], "env": { "ALLOWED_BASE_DIR": "/Users/you/Downloads", "FFL_USE_STDIN": "1" } } } }

Additional options forfflShareFile/fflShareFiles:

Preview sidecar routes (/manifest,/file,/thumb) are only created for folder shares and multi-file shares. Single-file shares are served as direct file links, even whenpreview=True. MCP returns the base FastFileLink URL and does not append?preview=true; users may add that query string manually.

Response fields:sessionId,link,pid,qrCode?(ASCII art whenqrInTerminal=True),debugLogPath?

fflDownload(url, outputPath?, resume?, authUser?, authPassword?, recipientAuth?, pickupCode?, recipientPrivateKey?, proxy?, enableReporting?) -> {ok, returncode, outputPath?, transferMode?, transferInfo?, message?, ...}

Downloads from FastFileLink URLs (WebRTC P2P when possible, HTTP fallback) or any HTTP(S) URL (works like wget).

For authenticated links: passrecipientAuth+pickupCode(pickup mode) orrecipientPrivateKey(pubkey mode). SetenableReporting=Trueonly when you want to opt into ffl diagnostic error reporting for troubleshooting.

fflKeygen(name?) -> {ok, returncode, output}

Generates an RSA keypair for passwordlesspubkeyrecipient auth:

- <name>.fflpub— share with the sender (pass asrecipientPublicKey)
- <name>.fflkey— keep private (pass asrecipientPrivateKeywhen downloading)

- fflListSessions()— list active share sessions
- fflStopSession(sessionId)— terminate a session
- fflGetSession(sessionId)— get session details
- fflGetSessionEvents(sessionId, limit=50)— retrieve webhook events

- FFL_USE_STDIN=1avoids writing text/base64 payloads to disk.
- FFL_RUN_MODE=pythonruns the Core.py CLI (requiresFFL_CORE_PATH).
- FFL_USE_HOOK=1starts a local webhook server and passes it tofflfor real-time link/progress events.
- FFL_DEBUG=1saves ffl output to a temp log file; path returned asdebugLogPath. SetFFL_DEBUG=/path/to/log.txtto use a fixed path.
- ALLOWED_BASE_DIRrestrictsfflShareFile/fflShareFilesto a specific directory.