ffl MCP

MCP办公协作

提供方 nuwainfo

办公协作 stdio · 本地进程 会话登录 社区 / 第三方 Claude DesktopClaude
查看接入方式

ffl-mcp是一个本地化的MCP服务器,允许用户通过AI共享任何文件或文件夹,生成HTTPS链接供他人访问,支持P2P协作和调试。

一句话选型结论

按资料字段整理

ffl MCP 属于办公协作类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件共享Python本地部署P2P传输本地服务器协作工具HTTPS链接

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
uvx --from git+https://github.com/nuwainfo/ffl-mcp install

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ffl MCP当前 8 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方nuwainfo上游标注的维护方 nuwainfo
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.1 KB
来自项目仓库与上游目录的原文,未做删改

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——一行```bash

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


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

### Windows--单行程序(PowerShell)```powershell
iwr -useb https://raw.githubusercontent.com/nuwainfo/ffl-mcp/refs/heads/main/install.ps1 | iex

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

uvx(无二进制,需要uv)```bash

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


目标可以通过以下方式控制 `--target` (默认值:全部):```bash
uvx --from git+https://github.com/nuwainfo/ffl-mcp install --target claude-desktop,codex-desktop,codex-cli
``````bash
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 自动。
对于自定义配置路径,请传递以下文件:```bash
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` 安装。```bash
# 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)```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"
}
}
}
}


______________________________________________________________________

## 工具

### 共享

|工具|输入|
|---|---|
| `fflShareText(text, name?, ...)` |纯文本|
| `fflShareBase64(dataB64, name?, ...)` |二进制数据(base64编码)|
| `fflShareFile(path, name?, ...)` |单个本地文件或文件夹|
| `fflShareFiles(paths, name?, ...)` |多个文件(ffl自动将它们压缩到一个下载中)|

**所有共享工具的常见选项:**

|选项|默认值|描述|
|---|---|---|
| `e2ee` | `False` |端到端加密|
| `qrInTerminal` | `False` |返回ASCII二维码艺术(`qrCode` 作为回应)|
| `authUser` / `authPassword` |--| HTTP基本身份验证以保护链接|
| `maxDownloads` | `1` |下载N次后停止服务(仅P2P)|
| `timeoutSeconds` | `1800` |非活动超时(秒)(仅P2P)|
| `recipientAuth` | — | `pickup` (6位代码), `pubkey` (RSA), `pubkey+pickup`,或 `email` (OTP)|
| `pickupCode` |auto |特定提货代码 `pickup` 模式|
| `recipientPublicKey` |--|路径 `.fflpub` 提交 `pubkey` 模式|
| `recipientEmail` |--|的电子邮件 `email` OTP模式,逗号分隔|
| `alias` |--|自定义链接别名,例如。 `my-release` (需要标准+帐户)|
| `receipt` |--|收件人下载时的电子邮件通知|
| `receiptConfirm` |--|下载前需要收件人确认;传递消息或 `""` |
| `forceRelay` | `False` |禁用WebRTC,通过隧道路由所有流量|
| `port` |--|本地HTTP服务器端口(默认情况下自动检测)。适用于固定隧道。 |
| `invite` | `False` |使用生成的共享链接在本地浏览器中打开ffl邀请页面。 |
| `enableReporting` | `False` |启用ffl诊断错误报告。默认情况下禁用。 |
| `upload` |--|上传到FFL服务器而不是P2P--例如。 `"1 day"`, `"6 hours"` (需要标准+帐户)|
| `resumeUpload` | `False` |恢复中断的上传|
| `proxy` |--|代理URL,例如。 `socks5://127.0.0.1:9050` |

**其他选项 `fflShareFile` / `fflShareFiles`:**

|选项|默认值|描述|
|---|---|---|
| `preview` | `False` |为文件夹或多文件共享启用预览sidecar路由。返回的链接保持干净;添加 `?preview=true` 当您想要浏览器预览视图时手动。 |
| `exclude` |--|要排除的Glob或正则表达式模式,逗号分隔--例如。 `*.pyc,__pycache__` 或 `re:\.env$` |
| `pause` |--|以1到99的百分比暂停服务器上载。需要 `upload`. |
| `vfs` | `False` |显示为VFS服务器(`vfs://` URI)-- `fflShareFile` 只有|
| `preferredTunnel` |--|设置此运行和未来运行的首选隧道-- `cloudflare`, `ngrok`, `bore`等等。 |

预览侧车路线(`/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)下载。

transferMode 含义
webrtc_p2p 直接对等(最快)
http_fallback WebRTC失败时的HTTP中继
http_direct 常规HTTP下载(非FastFileLink URL)

对于经过身份验证的链接: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` 到一个特定的目录。

______________________________________________________________________

## 测试```bash
# 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 文件夹:bash sudo sh -c 'echo -1 > /proc/sys/fs/binfmt_misc/WSLInterop'

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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ffl MCP 怎么安装?

在客户端按下面的安装命令接入:uvx --from git+https://github.com/nuwainfo/ffl-mcp install。装完在客户端配置里引用同一个包或端点。

ffl MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ffl MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ffl MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

ffl MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ffl MCP 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 本地服务器、Python、Claude、协作工具。具体工具清单以官方文档为准。

ffl MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

ffl MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。