@noranekob/fal-mcp-server

@noranekob/fal-mcp-server

任意のファイル（画像、動画、音声、テキストなど）をfal.aiにアップロードしてリモートURLを取得するModel Context Protocol (MCP) サーバーです。

機能

• 任意のファイルをfal.aiクラウドストレージにアップロード
• アップロードしたファイルの共有可能なリモートURLを取得
• 幅広いファイル形式をサポート
  • 画像: JPG、PNG、GIF、WebP、BMP
  • 動画: MP4、MOV、AVI、WebM
  • 音声: MP3、WAV、AAC、OGG
  • テキスト: TXT、JSON、CSV、XML
  • その他: PDF、ZIP、バイナリファイルなど
• ファイルサイズ検証 (最大500MB)
• MIME typeの自動判定

インストール

npxを使用 (推奨)

# インストール不要、下記のClaude Code設定ファイルに記述するだけで使用可能（下記設定ファイルでは記述済み）
npx @noranekob/fal-mcp-server

グローバルインストール

npm install -g @noranekob/fal-mcp-server

セットアップ

1. fal.ai APIキーを取得

1. fal.ai でサインアップ
2. ダッシュボードでAPIキーを作成
3. APIキーをコピー

2. Claude Codeの設定

Claude Codeの設定ファイル (~/.claude/settings.json) に以下を追加:

{
  "mcpServers": {
    "fal-mcp-server": {
      "command": "npx",
      "args": ["@noranekob/fal-mcp-server"],
      "env": {
        "FAL_KEY": "あなたのfal-api-key"
      }
    }
  }
}

あなたのfal-api-key を実際のfal.ai APIキーに置き換えてください。

使用方法

設定完了後、Claude Codeで以下のツールを使用できます:

upload_file_to_fal

任意のファイルをfal.aiにアップロードしてリモートURLを取得します。

パラメータ:

• file_path (文字列、必須): アップロードするファイルのパス

使用例:

/path/to/image.jpg の画像をfalにアップロード
/path/to/video.mp4 の動画をfalにアップロード
/path/to/audio.mp3 の音声をfalにアップロード
/path/to/document.pdf のPDFをfalにアップロード
/path/to/document.pdf のPDFをfalにアップロードして動画を生成して

必要環境

• Node.js 18.0.0 以上
• 有効なfal.ai APIキー

Python等の追加ランタイムは不要です（v1.1.0からNode.js単体で動作します）。

サポートされるファイル形式

画像

• JPEG/JPG、PNG、GIF、WebP、BMP

動画

• MP4、MOV、AVI、WebM、MKV

音声

• MP3、WAV、AAC、OGG、FLAC

テキスト・ドキュメント

• TXT、JSON、CSV、XML、PDF

アーカイブ

• ZIP、TAR、GZ

その他

• 任意のバイナリファイル

制限事項

• 最大ファイルサイズ: 500MB
• ファイル形式の制限なし（fal.aiがサポートする全形式に対応）

トラブルシューティング

"FAL_KEY not found in environment variables" エラー

セットアップセクションで示されているように、Claude Codeの設定にfal.ai APIキーを追加していることを確認してください。

"Python not found" エラー (v1.0.x)

v1.0.x はアップロード処理にPythonを使用していたため、Python環境がないマシン（またはNodeのspawnがpyenv等のshimを解決できない環境）では終了コード9009で失敗していました。v1.1.0以降はNode.js単体で動作するため、最新版に更新してください:

npx clear-npx-cache 2>/dev/null; npx @noranekob/fal-mcp-server

ライセンス

MIT

作者

noranekob

リンク

• GitHubリポジトリ
• 問題を報告
• fal.ai ドキュメント