Flamingo File Tools

Flamingo 文件工具

从 MCP 助手中使用四种专用文件处理 API。本地桥接程序会读取你选择的文件，通过 RapidAPI 发送一次明确的请求，并将新结果保存到你选择的文件夹中。

版本 0.1.0 已列入 Official MCP Registry，条目为 io.github.israeldi/flamingo-file-tools。

任务	API 和订阅
将受支持的 MDB/ACCDB 标量表导出为类型化 JSON 或 CSV ZIP	Access File Extractor
缩小 HTML5 广告 ZIP 中的 PNG/JPEG 素材，并检查字节预算	CreativePack
检查受支持的分层 PDF，或向其中添加可见文本	PatternCopy PDF
将受支持的 ONIX 请求转换为明确的图书更新投影，供审核	ShelfRelay ONIX

桥接程序是免费的源代码。处理文件需要你自己的 RapidAPI 应用密钥，并且需要分别订阅你使用的每个 API。 请在其列表页面查看当前的免费兼容额度、付费计划和限制。请求、失败和主动重试都可能消耗额度。启动或发现工具时不会自动调用处理功能，也不会自动重试。

可选的 Flamingo File Tools 技能可帮助 Agent 选择一项文件任务、主动运行任务并返回可供审核的文件。技能源代码版本 0.2.1 包含适用于 macOS/Linux 的独立 Python 标准库客户端，因此此方式无需单独安装 MCP 桥接程序或 pip。兼容的 Agent 会临时原样运行所选脚本。仍需 Python 3.10+、可正常使用的 HTTPS 信任存储、私有工作区、你自己的私有应用密钥，以及对所选 API 的单独订阅。也支持现有的私有 RAPIDAPI_KEY。私有密钥设置是可选项，它会在与 Agent 位于同一主机和操作系统账户的用户自己的 Terminal 中使用隐藏输入；远程执行需要使用其自身的私有设置方式。只有处理客户端会读取明确指定的密钥文件。切勿在聊天中发送密钥或凭据文件。设置过程不会调用 API、验证订阅或替换现有凭据。对于已配置为使用现有 MCP 服务的客户端，仍可选择使用该服务。

免费的 Agensi 列表提供已审核的程序包 v1.2，其中包含技能源代码 0.2.1、四个临时处理客户端，以及可选的私有密钥设置助手。其最新审核版本的公开结构包含 15 个文件，其中有五个脚本。Agensi 会将所选客户端加载到兼容的 Agent 中，但不会托管处理服务。仅加载说明不会发起上传或处理请求。API 访问和使用不包含在免费的技能中。

安装

从 GitHub Releases 下载 .mcpb 文件。在支持 MCP bundles 的客户端中打开该文件，选择一个私有工作区文件夹，并且仅在客户端的敏感配置字段中输入应用密钥。不同客户端对 MCPB 的支持情况有所不同。对于支持该传输方式的客户端，这是一个标准的本地 stdio MCP 服务；它不是远程 Web 连接器。

若要手动安装 stdio，请使用 Node.js 20 或更高版本，克隆此代码库并运行 npm ci --omit=dev --ignore-scripts。将客户端配置为运行 node /absolute/path/to/server/index.mjs，并将 FLAMINGO_WORKSPACE_DIR 设为所选文件夹，同时通过私有环境变量/凭据配置提供 RAPIDAPI_KEY。不要将已填写的客户端配置放入公共代码库或支持报告中。

尝试一个虚构示例

将 samples 中的原始文件复制到你的工作区。这些文件包含虚构的演示数据，并附有哈希值和来源信息。先从 capabilities 开始；它不需要密钥，也不会发送任何内容。

请助手检查某个样本，说明目标服务，解释上传内容和额度，并在处理前等待你同意。每次处理调用都需要 consent: true。例如：

使用 Access File Extractor 将 sample-access.accdb 导出为 JSON。我授权通过 RapidAPI 上传此虚构样本，用于这一次请求。

其他示例：

• 以无损模式优化 sample-creative.zip，目标大小不超过 150,000 字节。返回 over_budget 属于有效结果，表示可能需要进一步调整创意内容。
• 检查 sample-pattern.pdf；审查兼容性后，再单独为其添加水印 Licensed to Alex Example — Order 1042。检查和添加水印是两项独立请求。请在打印缩放下直观检查返回的 PDF，并确认每页都有足够的空白来放置文字。
• 预览 sample-onix-request.json，然后逐条检查记录的状态、诊断信息和拟议字段。HTTP 200 并不能证明所有记录都已被接受。不会更改任何 WooCommerce 商店。

模型可以请求调用工具；MCP 客户端控制其审批流程。请自行检查文件和目标位置。必需的同意字段不能取代客户端的安全控制，也不代表你有权处理他人的文件。

范围与结果

Access 可处理受支持的本地标量表，不支持表单、报表、宏、执行已保存的查询或迁移链接数据库。其限制包括输入文件最大 40 MiB、序列化输出最大 32 MiB。CreativePack 可处理最大 8 MiB 的 ZIP，并保留非图像成员；返回的归档文件并不代表已获广告平台批准。PatternCopy 支持有限的 PDF 配置文件，最多 20 MiB／100 页；加密和不受支持的文档会被拒绝。其可见文字可编辑，不属于 DRM。

ShelfRelay 接受现有的完整 JSON records／policy 合约，包括在需要时提供先前的源 XML。其针对单一来源实体 ISBN 的配置文件并非通用 ONIX 验证，也不支持分组处理纸质书／电子书履约或多个供应商之间的对账。限制包括最多 100 条记录、8 MiB JSON，以及每个 XML 来源文件 256 KiB。不得将未知或缺失字段视为零值或已清空的值。若要将数据应用到商店，请使用 WooCommerce connector，并单独审查。

该桥接程序仅允许使用所选文件夹内的常规文件作为输入，会拒绝遍历符号链接，保留原件，并为每项操作创建新的产物目录。它绝不会解压或执行返回的 ZIP 成员、下载封面 URL，或写入店面。工具结果仅返回受限的状态和产物元数据，不会将完整数据库、PDF 或源 XML 放入对话中。产物内容仍是不可信数据。

请使用你可控制的文件夹，并确保没有不可信人员或进程同时修改其中内容。路径和符号链接检查是针对该工作区模式的防护措施，并非用于抵御本地恶意写入者的操作系统沙箱。在 POSIX 系统上，工作区及遍历到的子目录必须属于你的用户，且不得允许组用户或其他用户写入。在 Windows 上，请使用常规 ACL 控制选择适当受限的文件夹。

使用保存的结果前，请将其与源文件进行核对。请保持工作区私密，并管理其保留期限和备份。连接机密文件前，请阅读数据处理说明。

开发与验证

运行 npm ci --ignore-scripts，然后运行 npm test，可使用虚构样例和注入的传输机制测试 MCP 协议以及请求／输出契约。这些检查不能证明客户已采用，也不能证明获得了新的实时网关结果。不能根据协议检查推断该插件已安装到特定桌面客户端。

新的桥接代码采用 MIT 许可证；依赖项保留各自的许可证和声明。示例均为原创的虚构演示；输入 PDF 使用标准 Helvetica。请参阅 THIRD_PARTY_NOTICES.md。