Fal Api MCP Server

🚀 fal-api-mcp-server

このサーバーは、Model Context Protocol (MCP)に基づいて構築され、fal.aiのFLUX.1 Proモデルを使用して画像生成機能を提供します。

✨ 主な機能

📦 リソース

このサーバーは、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

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

3. PyPIに公開します。

uv publish

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

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

🐞 デバッグ

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

以下のコマンドでMCP Inspectorを起動できます。

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

起動後、InspectorはURLを表示し、ブラウザでアクセスしてデバッグを開始できます。