Fal.ai OpenAI Image MCPサーバー

fal.aiのGPT image-1 text-to-image APIを使用して画像を生成するFastMCPサーバーです。

セットアップ

1. 依存関係をインストール:

npm install

2. 環境変数としてAPIキーを設定:

export FAL_KEY="your_fal_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"

3. プロジェクトをビルド:

npm run build

4. サーバーを実行:

npm start

使用方法

サーバーは以下のツールを提供します:

generate_image

テキストプロンプトを使用して画像を生成します。

パラメーター:

• prompt (必須): 生成する画像のテキスト説明
• image_size (オプション): 生成する画像のサイズ ("auto", "1024x1024", "1536x1024", "1024x1536")
• num_images (オプション): 生成する画像の数 (1-4)
• quality (オプション): 生成する画像の品質 ("auto", "low", "medium", "high")
• background (オプション): 背景のタイプ ("auto", "transparent", "opaque")

例:

{
  "prompt": "夕暮れの静謐なサイバーパンク都市風景",
  "image_size": "1024x1024",
  "num_images": 1,
  "quality": "high"
}

Claude Codeでの使用

Claude Codeでこのサーバーを使用するには、以下のJSONをMCP設定に追加してください:

{
  "mcpServers": {
    "fal-openai-image": {
      "command": "node",
      "args": ["/path/to/fal_openai_image1/dist/index.js"],
      "env": {
        "FAL_KEY": "your_fal_api_key_here",
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

または、開発モードで実行する場合:

{
  "mcpServers": {
    "fal-openai-image": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/fal_openai_image1",
      "env": {
        "FAL_KEY": "your_fal_api_key_here",
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

環境変数

• FAL_KEY: 必須。fal.ai API認証用のAPIキー
• OPENAI_API_KEY: 必須。BYOK (Bring Your Own Key) システム用のOpenAI APIキー