fal-api-mcp-server

fal-api-mcp-server

fal.ai の FLUX.1 Pro モデルを使用して画像生成機能を提供する Model Context Protocol（MCP）サーバーです。

コンポーネント

リソース

fal.ai は主にステートレスなモデル実行サービスであるため、このサーバーは永続的なリソースを提供しません。

ツール

このサーバーは、次のツールを実装しています。

• generate_image：fal.ai FLUX.1 Pro を使用して、テキストプロンプトに基づいて画像を生成します
  • 必須パラメーター：
    • prompt：画像生成に使用するテキストプロンプト
  • 任意のパラメーター：
    • image_size：希望する画像サイズ（デフォルト："landscape_4_3"）
      • 選択肢："square_hd"、"square"、"portrait_4_3"、"portrait_16_9"、"landscape_4_3"、"landscape_16_9"
    • num_images：生成する画像の枚数（デフォルト：1）
    • enable_safety_checker：セーフティチェッカーを有効にします（デフォルト：true）
    • safety_tolerance：セーフティ許容レベル（1〜6）。数値が大きいほど許容度が高くなります（デフォルト："2"）
    • output_format：出力画像形式。"jpeg" または "png"（デフォルト："jpeg"）

設定

このサーバーを正しく動作させるには、fal.ai API キーが必要です。fal.ai に登録して API キーを取得できます。

API キーは環境変数として設定してください。

FAL_KEY=your_fal_ai_api_key

この環境変数はシェルで設定するか、上記の内容を記述した .env ファイルをサーバーと同じディレクトリに作成してください。

デモ

https://github.com/user-attachments/assets/564a0fc3-9204-4399-b1ea-ab6a5c9f2d84

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "fal-api-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/fal-api-mcp-server",
      "run",
      "fal-api-mcp-server"
    ],
    "env": {
      "FAL_KEY": "your_fal_ai_api_key"
    }
  }
}

"mcpServers": {
  "fal-api-mcp-server": {
    "command": "uvx",
    "args": [
      "fal-api-mcp-server"
    ],
    "env": {
      "FAL_KEY": "your_fal_ai_api_key"
    }
  }
}

使用方法

サーバーの設定と起動が完了したら、Claude で画像を生成できます。プロンプトの例：

• 「夕焼けの山の風景を生成して」
• 「ネオンライトが輝くサイバーパンクキャラクターのポートレートを作成して」
• 「空飛ぶ車が行き交う未来都市の風景を見せて」

Claude は fal.ai FLUX.1 Pro モデルを使用して、指定された画像を生成します。

開発

ビルドと公開

パッケージを配布できる状態にするには：

1. 依存関係を同期し、ロックファイルを更新します：

uv sync

2. パッケージの配布物をビルドします：

uv build

これにより、ソース配布物と wheel 配布物が dist/ ディレクトリに作成されます。

3. PyPI に公開します：

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で動作するため、デバッグが難しい場合があります。最適なデバッグ体験のため、MCP Inspector の使用を強くおすすめします。

次のコマンドを使って、npm 経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/fal-api-mcp-server run fal-api-mcp-server

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスすると、デバッグを開始できます。