Flamingo File Tools

Flamingo File Tools

MCP アシスタントから、用途を絞った 4 つのファイル処理 API を利用できます。ローカルブリッジが選択したファイルを読み込み、RapidAPI 経由で明示的なリクエストを 1 回送信し、選択したフォルダーに新しい結果を保存します。

バージョン 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 の個別のサブスクリプションが必要です。 各 API の掲載ページで、現在の無料利用枠、料金プラン、制限をご確認ください。リクエスト、失敗、明示的な再試行によって利用枠が消費される場合があります。起動時やツール検出時に自動で処理リクエストが送信されることはなく、自動再試行もありません。

任意の Flamingo File Tools スキルを使用すると、エージェントがファイルタスクを 1 つ選び、明示的に実行し、レビュー可能な成果物を返すのに役立ちます。スキルソースのバージョン 0.2.1 には、macOS/Linux 向けの独立した Python 標準ライブラリクライアントが含まれているため、この方法では別途 MCP ブリッジや pip のインストールは不要です。互換性のあるエージェントは、選択したスクリプトを変更せずに一時的に実行します。Python 3.10 以降、正常に動作する HTTPS 信頼ストア、プライベートワークスペース、ご自身のプライベートアプリケーションキー、および選択した API の個別のサブスクリプションは引き続き必要です。既存のプライベートな RAPIDAPI_KEY も引き続き使用できます。任意のプライベートファイル設定では、エージェントと同じホストおよび OS アカウント上で、ユーザー自身のターミナルに隠し入力を使用します。リモート実行では、独自のプライベート設定方法が必要です。明示的に選択されたキーファイルを読み取るのは処理クライアントだけです。キーや認証情報ファイルをチャットで送信しないでください。設定によって API が呼び出されたり、サブスクリプションが確認されたり、既存の認証情報が置き換えられたりすることはありません。既存の MCP サーバーも、すでに設定済みのクライアントで使用できる代替手段です。

無料の Agensi 掲載ページでは、スキルソース 0.2.1、4 つの一時処理クライアント、任意のプライベートキー設定ヘルパーを含む、承認済みパッケージ v1.2 を提供しています。公開されている最新の承認済み構成には、5 つのスクリプトを含む 15 個のファイルがあります。Agensi は選択されたクライアントを互換性のあるエージェントに読み込みますが、処理サービスをホストするものではありません。読み込み手順を実行しただけでアップロードや処理のリクエストが送信されることはありません。API へのアクセスと利用は、無料のスキルとは別です。

インストール

GitHub Releases から .mcpb ファイルをダウンロードします。MCP バンドルに対応するクライアントで開き、プライベートワークスペースフォルダーを選択して、クライアントの機密情報用設定フィールドにのみアプリケーションキーを入力します。MCPB の対応状況はクライアントによって異なります。これは、そのトランスポートに対応するクライアント向けの標準的なローカル stdio MCP サーバーであり、リモートのウェブコネクターではありません。

手動で stdio にインストールする場合は、Node.js 20 以降を使用し、このリポジトリをクローンして npm ci --omit=dev --ignore-scripts を実行します。クライアントを、選択したフォルダーを FLAMINGO_WORKSPACE_DIR に設定し、プライベートな環境変数／認証情報設定を通じて RAPIDAPI_KEY を渡したうえで、node /absolute/path/to/server/index.mjs を実行するように設定します。入力済みのクライアント設定を、公開リポジトリやサポート報告に含めないでください。

架空の例を試す

サンプルから元のファイルをワークスペースにコピーします。これらのファイルには、架空のデモデータが含まれています。ハッシュと出所情報も記載されています。キーが不要で、データを送信しないcapabilitiesから始めてください。

アシスタントに特定のサンプルを調べるよう依頼し、送信先サービスを指定して、アップロード内容と利用枠について説明させ、処理前に同意を求めるようにしてください。処理を行う各呼び出しでは、consent: trueが必要です。例：

Access File Extractorを使用して、sample-access.accdbをJSONとしてエクスポートしてください。この架空のサンプルを、この1回のリクエストに限り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は、必要に応じて元のXMLを含む、既存の完全なJSON records／policy契約を受け付けます。物理ISBNかつ単一ソースのプロファイルは、汎用的なONIX検証、印刷版と電子書籍のグループ化されたフルフィルメント、複数サプライヤーの照合には対応していません。制限には、レコード100件、JSON 8 MiB、XMLソースあたり256 KiBがあります。不明または存在しないフィールドを、ゼロやクリア済みの値として扱ってはいけません。ストアへの適用には、別途確認を行うWooCommerceコネクターを使用してください。

ブリッジは入力を選択したフォルダー内の通常ファイルに限定し、シンボリックリンクをたどる操作を拒否し、元のファイルを保持し、操作ごとに新しい成果物ディレクトリを作成します。返されたZIPの内容を展開または実行したり、カバー画像のURLをダウンロードしたり、ストアフロントに書き込んだりすることはありません。ツールの結果として返されるのは、上限付きのステータスと成果物のメタデータです。データベース、PDF、元のXML全体が会話に含まれることはありません。成果物の内容は、信頼できないデータとして扱ってください。

信頼できない人やプロセスが同時に変更しない、自分が管理するフォルダーを使用してください。パスとシンボリックリンクのチェックは、そのワークスペースモデルにおける保護策であり、敵意のあるローカル書き込みに対するオペレーティングシステムのサンドボックスではありません。POSIXシステムでは、ワークスペースと、その中をたどるすべてのサブディレクトリが自分のユーザーに属し、グループや他のユーザーが書き込み可能であってはなりません。Windowsでは、通常のACL制御を使用して適切にアクセスを制限したフォルダーを選んでください。

保存した結果は、使用する前に元データと照合してください。ワークスペースを非公開に保ち、保存期間とバックアップを管理してください。機密ファイルを接続する前に、データの取り扱いをお読みください。

開発と検証

npm ci --ignore-scripts の後に npm test を実行すると、架空のフィクスチャと注入されたトランスポートを使用して、MCP プロトコルとリクエスト／出力の契約を検証します。これらのチェックによって、顧客による導入や、新たなライブゲートウェイの結果が確認されるわけではありません。特定のデスクトップクライアントへのバンドルのインストール状況を、プロトコルのチェックから推測することはできません。

新しいブリッジコードは MIT ライセンスです。依存関係には、それぞれのライセンスと通知が適用されます。サンプルはオリジナルの架空のデモであり、入力 PDF には標準の Helvetica を使用しています。THIRD_PARTY_NOTICES.md を参照してください。