ffl-mcp (local-only)

MCP server for ffl. Let AI share anything for you.

Backed by ffl, which turns any file/folder into an HTTPS link.

This is a minimal MCP server that shells out to `ffl` / `ffl.com` locally.

No file contents are sent to the LLM; the model only triggers local `ffl`.

This demo shows collaborative debugging: Claude on the left shares a local environment (DB + logs) via P2P link, Claude on the right downloads and diagnoses the error. In this scenario, the two Claudes represent different people working on separate machines.

Table of Contents

• Installation
  • Windows — GUI Installer
  • Linux / macOS — one-liner
  • Windows — one-liner (PowerShell)
  • uvx (no binary, requires uv)
  • Run directly (development)
• MCP Config (manual JSON)
• Tools
  • Sharing
  • Downloading
  • Keygen
  • Session Management
• Notes
• Testing
• WSL2 Users

Installation

> ⚡ Short URLs for convenience

>

>

> 🔒 `fastfilelink.com/mcp/*` is a redirect to GitHub. Use the direct GitHub URLs below if you prefer.

Windows — GUI Installer

Download and run **ffl-mcp-setup.exe** from the latest release.

No command line needed — the installer registers ffl-mcp with Claude Desktop and Claude Code automatically.

Linux / macOS — one-liner

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

Downloads the platform binary from the latest GitHub release and runs `ffl-mcp install` to register with Claude. Falls back to `uvx` automatically if no binary is available for your platform.

Windows — one-liner (PowerShell)

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

Downloads `ffl-mcp.exe` from the latest GitHub release and registers it with Claude.

uvx (no binary, requires uv)

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

Targets can be controlled with `--target` (default: all):

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

If Claude Code CLI is installed, the installer also runs `claude mcp add` automatically (user scope).

The installer also writes Codex MCP config to `~/.codex/config.toml` for Codex Desktop/CLI/IDE.

If Codex CLI is installed, the installer also runs `codex mcp add` automatically.

For custom config paths, pass the file:

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

Run directly (development)

Prereq: `uv` installed.

# 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

MCP Config (manual JSON)

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

Tools

Sharing

Common options for all share tools:

Additional options for `fflShareFile` / `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 when `preview=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 when `qrInTerminal=True`), `debugLogPath?`

Downloading

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: pass `recipientAuth` + `pickupCode` (pickup mode) or `recipientPrivateKey` (pubkey mode).

Set `enableReporting=True` only when you want to opt into ffl diagnostic error reporting for troubleshooting.

Keygen

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

Generates an RSA keypair for passwordless `pubkey` recipient auth:

• `.fflpub` — share with the sender (pass as `recipientPublicKey`)
• `.fflkey` — keep private (pass as `recipientPrivateKey` when downloading)

Session Management

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

Notes

• `FFL_USE_STDIN=1` avoids writing text/base64 payloads to disk.
• `FFL_RUN_MODE=python` runs the Core.py CLI (requires `FFL_CORE_PATH`).
• `FFL_USE_HOOK=1` starts a local webhook server and passes it to `ffl` for real-time link/progress events.
• `FFL_DEBUG=1` saves ffl output to a temp log file; path returned as `debugLogPath`. Set `FFL_DEBUG=/path/to/log.txt` to use a fixed path.
• `ALLOWED_BASE_DIR` restricts `fflShareFile`/`fflShareFiles` to a specific directory.

Testing

# Unit + binary tests (no network needed)
python -m unittest discover -s tests -p "*Test.py" -v

# All tests including share/download round-trips (requires network)
FFL_INTEGRATION_TESTS=1 python -m unittest discover -s tests -p "*Test.py" -v

WSL2 Users

If you encounter `TLSError([0x6300])` errors, run this command to disable Windows interop for `.com` files:

sudo sh -c 'echo -1 > /proc/sys/fs/binfmt_misc/WSLInterop'

This allows ffl.com (APE binary) to run natively on Linux instead of being executed through Windows.