# Fal.ai OpenAI Image MCPサーバー
fal.aiのGPT image-1 text-to-image APIを使用して画像を生成するFastMCPサーバーです。
## セットアップ
1. 依存関係をインストール:
```bash
npm install
```
2. 環境変数としてAPIキーを設定:
```bash
export FAL_KEY="your_fal_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
```
3. プロジェクトをビルド:
```bash
npm run build
```
4. サーバーを実行:
```bash
npm start
```
## 使用方法
サーバーは以下のツールを提供します:
### generate_image
テキストプロンプトを使用して画像を生成します。
**パラメーター:**
- `prompt` (必須): 生成する画像のテキスト説明
- `image_size` (オプション): 生成する画像のサイズ ("auto", "1024x1024", "1536x1024", "1024x1536")
- `num_images` (オプション): 生成する画像の数 (1-4)
- `quality` (オプション): 生成する画像の品質 ("auto", "low", "medium", "high")
- `background` (オプション): 背景のタイプ ("auto", "transparent", "opaque")
**例:**
```json
{
"prompt": "夕暮れの静謐なサイバーパンク都市風景",
"image_size": "1024x1024",
"num_images": 1,
"quality": "high"
}
```
## Claude Codeでの使用
Claude Codeでこのサーバーを使用するには、以下のJSONをMCP設定に追加してください:
```json
{
"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"
}
}
}
}
```
または、開発モードで実行する場合:
```json
{
"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キー
