ffl MCP

ffl-mcp（仅限本地）

用于ffl的MCP服务器。让AI为你分享一切。

由...支持 前锋，它将任何文件/文件夹转换为HTTPS链接。

这是一个最小的MCP服务器 ffl / ffl.com 当地。 不向LLM发送文件内容；该模型仅触发局部 ffl.

此演示显示了协作调试：左侧的Claude通过P2P链接共享本地环境（DB+日志），右侧的Claude下载并诊断错误。在这种情况下，两个Claudes代表在不同机器上工作的不同人员。

______________________________________________________________________

目录

• 安装

- Windows--图形用户界面安装程序 - Linux/macOS——一行 - Windows--单行程序（PowerShell） - uvx（无二进制，需要uv） - 直接运行（开发）

• MCP配置（手动JSON）
• 工具

- 共享 - 下载中 - 注册机 - 会话管理

• 备注
• 测试
• WSL2用户

______________________________________________________________________

安装

⚡ 为方便起见，使用短网址 - Linux/macOS： curl -fsSL https://fastfilelink.com/mcp/install.sh | bash - Windows（脚本）： iwr -useb https://fastfilelink.com/mcp/install.ps1 | iex 🔒 fastfilelink.com/mcp/* 重定向到GitHub。如果你愿意，可以使用下面的直接GitHub网址。

Windows--图形用户界面安装程序

下载并运行 ffl-mcp-setup.exe 从最新版本。

无需命令行——安装程序会自动在Claude Desktop和Claude Code中注册ffl-mcp。

Linux/macOS——一行

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

从最新的GitHub版本下载平台二进制文件并运行 ffl-mcp install 向克劳德注册。回落到 uvx 如果您的平台没有可用的二进制文件，则自动执行。

Windows--单行程序（PowerShell）

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

下载 ffl-mcp.exe 从最新的GitHub版本中下载并向Claude注册。

uvx（无二进制，需要uv）

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

目标可以通过以下方式控制 --target （默认值：全部）：

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

如果安装了Claude Code CLI，安装程序也会运行 claude mcp add 自动（用户范围）。 安装程序还将Codex MCP配置写入 ~/.codex/config.toml 用于Codex桌面/CLI/IDE。 如果安装了Codex CLI，安装程序也会运行 codex mcp add 自动。 对于自定义配置路径，请传递以下文件：

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

直接运行（开发）

先决条件： uv 安装。

# 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配置（手动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"
      }
    }
  }
}

______________________________________________________________________

工具

共享

所有共享工具的常见选项：

其他选项 fflShareFile / fflShareFiles:

预览侧车路线(/manifest, /file, /thumb)仅为创建 文件夹共享和多文件共享。单个文件共享用作直接文件 链接，即使在 preview=True.MCP返回基本FastFileLink URL 不追加 ?preview=true；用户可以手动添加该查询字符串。

响应字段： sessionId, link, pid, qrCode? （ASCII艺术时 qrInTerminal=True), debugLogPath?

下载中

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

从FastFileLink URL（可能的话是WebRTC P2P，HTTP回退）或任何HTTP（S）URL（类似于wget）下载。

对于经过身份验证的链接：pass recipientAuth + pickupCode （拾取模式）或 recipientPrivateKey （公钥模式）。 集 enableReporting=True 只有当您想选择使用ffl诊断错误报告进行故障排除时。

注册机

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

为无密码生成RSA密钥对 pubkey 收件人身份验证：

• .fflpub --与发件人共享（传递为 recipientPublicKey)
• .fflkey --保持私密（通行证为 recipientPrivateKey 下载时）

会话管理

• fflListSessions() --列出活动共享会话
• fflStopSession(sessionId) --终止会话
• fflGetSession(sessionId) --获取会话详细信息
• fflGetSessionEvents(sessionId, limit=50) --检索webhook事件

______________________________________________________________________

备注

• FFL_USE_STDIN=1 避免将文本/base64有效载荷写入磁盘。
• FFL_RUN_MODE=python 运行Core.py CLI（需要 FFL_CORE_PATH).
• FFL_USE_HOOK=1 启动本地webhook服务器并将其传递给 ffl 用于实时链接/进度事件。
• FFL_DEBUG=1 将ffl输出保存到临时日志文件中；路径返回为 debugLogPath.Set FFL_DEBUG=/path/to/log.txt 使用固定路径。
• ALLOWED_BASE_DIR 限制 fflShareFile/fflShareFiles 到一个特定的目录。

______________________________________________________________________

测试

# 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用户

如果你遇到 TLSError([0x6300]) 错误，运行此命令以禁用Windows互操作 .com 文件夹：

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

这允许ffl.com（APE二进制文件）在Linux上本机运行，而不是通过Windows执行。