MCP Fal

🚀 fal.ai MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して fal.ai のモデルやサービスとやり取りするためのものです。

✨ 主な機能

• fal.ai で利用可能なすべてのモデルを一覧表示します。
• キーワードを使って特定のモデルを検索できます。
• モデルの OpenAPI スキーマを取得できます。
• 任意の fal.ai モデルを使用してコンテンツを生成できます。
• モデルの直接実行とキュー実行をサポートしています。
• キュー管理（状態確認、結果取得、リクエストのキャンセル）が可能です。
• ファイルを fal.ai CDN にアップロードできます。

📦 インストール

必要条件

• Python 3.10 以上のバージョン
• fastmcp ライブラリ
• httpx ライブラリ
• aiofiles ライブラリ
• fal.ai API キー

手順

1. このリポジトリをクローンします。

git clone https://github.com/am0y/mcp-fal.git
cd mcp-fal

2. 必要なパッケージをインストールします。

pip install fastmcp httpx aiofiles

3. あなたの fal.ai API キーを環境変数として設定します。

export FAL_KEY="YOUR_FAL_API_KEY_HERE"

💻 使用例

サーバーの起動

開発モードでサーバーを起動することができます。

fastmcp dev main.py

これにより、MCP チェッカーのウェブインターフェースが起動し、ツールをテストすることができます。

Claude Desktop でのインストール

サーバーを Claude Desktop と一緒に使用するには、次のコマンドを実行します。

fastmcp install main.py -e FAL_KEY="YOUR_FAL_API_KEY_HERE"

これにより、サーバーが Desktop アプリで利用可能になります。

直接実行

サーバーを直接実行することもできます。

python main.py

📚 ドキュメント

API リファレンス

ツール

• models(page=None, total=None) - すべての利用可能なモデルを一覧表示し、ページネーションクエリをサポートします。
• search(keywords) - キーワードでモデルを検索します。
• schema(model_id) - 特定のモデルの OpenAPI スキーマを取得します。
• generate(model, parameters, queue=False) - モデルを使用してコンテンツを生成し、キュー実行を選択できます。
• result(url) - キューに入れたリクエストの結果を取得します。
• status(url) - キューに入れたリクエストの状態を確認します。
• cancel(url) - キューに入れたリクエストをキャンセルします。
• upload(path) - ファイルを fal.ai CDN にアップロードします。

📄 ライセンス

MIT