Skip to main content
Glama
firefly-buddy-mcp

firefly-buddy-mcp

by holmesfems

firefly-buddy-mcp

テラコッタ色のロボが、波形を描いたカードをヘッドホンの人に手渡し、ホタルが飛ぶ中で効果音のファイルがフォルダに入っていく絵

この絵は gemini-buddy-mcp の gemini_generate_image(backend="agy")で作りました。

Claude が「この効果音を Adobe Firefly で作ってきて」と人間に頼むための MCP サーバー。 Firefly(Web)の生成クレジットを使って効果音を作り、ダウンロードしたファイルを Claude が指定したフォルダへ自動で届ける。

なぜ人間に頼むのか

  • Firefly の Web アプリのクレジットを使える API は無い(Firefly Services API は企業向けの別契約で、効果音の API も見当たらない)。

  • Adobe の生成 AI 利用ガイドラインは、許可のない自動化・スクリプトでの操作を禁じている。ブラウザを自動で操作しない。

  • 効果音は当たり外れが大きいので、Firefly が出す 4 案から人間が耳で選ぶ工程は、むしろあったほうがいい。

Related MCP server: spotter

流れ

Claude ── firefly_request_sfx(英語のプロンプトをまとめて)──▶ デスクトップに窓が出る
人間   ── 「コピーして受け取り開始」→ Firefly に貼って生成 → 気に入った案をダウンロード
窓     ── ダウンロードフォルダに届いたファイルを拾い、16bit PCM・48kHz の wav にして dest_dir へ
Claude ── firefly_status で受け取りを確かめる
  • 窓は、項目のボタンを押した後に届いた .wav だけを拾う(Firefly の効果音は .wav で落ちてくる)。それ以外のダウンロードには触らない。

  • 同じ中身のファイルは、同じ依頼の中で二度受け取らない(同じ案を二度落とした、受け取ったファイルを手で選び直した、など)。

  • 拾ったファイルの元(Firefly から落としたまま)は ~/.firefly-buddy-mcp/originals/<batch_id>/ に移す。

  • 拾い漏れたら、窓の「ファイルを選ぶ…」か、Claude の firefly_attach で渡せる。

  • 間違えて受け取ったファイルは、窓の「取り消す」で取り消せる(受け取り先のファイルを消す。Firefly から落とした元のファイルは残る)。

ツール

ツール

内容

firefly_request_sfx

効果音をまとめて頼む(1 回 12 件まで)。すぐ batch_id を返し、窓を開く

firefly_status

受け取りの状況。wait_seconds(110 秒まで)で、変化があるまで待てる。reopen_popup で窓を開き直す

firefly_attach

ファイルを手で渡す(コピーして変換する)

firefly_cancel

待っている項目を取り消す

項目(items の 1 つ):

キー

内容

name

できたファイルの名前(拡張子なし)。2 つ目からは _2・_3 が付く

prompt

Firefly に貼るプロンプト。英語だけ(Firefly の効果音は英語しか受け付けない)、750 字まで

note

人間向けの日本語のメモ(何に使うか・どんな音なら当たりか)

duration

長さ(秒、30 まで)。窓に「Duration を ◯ 秒に」と出る。Firefly の Duration は 1〜30 秒・0.1 秒刻みで既定が 8 秒。一発の音もそのままだと 8 秒の地鳴りになるので必ず付ける。届いた案の長さが 0.3 秒以上ずれていたら、受け取ったうえで注意を出す

dest_dir

入れる先(絶対パス)。省略すると ~/.firefly-buddy-mcp/outbox/<batch_id>/

want

4 案のうち何案まで残すか(1〜4)

convert

pcm16(16bit PCM・48kHz の wav。既定)か none(Firefly のファイルのまま)

trim_silence

頭の無音を切る(既定 true)

AK Studio の効果音で使う

dest_dir を <回のフォルダ>/fx/se/<種類>(chapter・slam・wipe・blip など)にすると、 AK Studio の「効果音の設定」の候補に自動で並ぶ(AK Studio は 16bit PCM の wav だけ読む)。 どれを鳴らすかは、ユーザーが聞き比べて決める。

入れ方

git clone https://github.com/holmesfems/firefly-buddy-mcp
cd firefly-buddy-mcp
python -m venv .venv
.venv\Scripts\python -m pip install -e .

venv 内の実行ファイルを指定して登録します(パスは clone した場所に合わせてください)。--scope user を付けると、どのプロジェクトからも使えます。

claude mcp add firefly-buddy --scope user -- "C:\path\to\firefly-buddy-mcp\.venv\Scripts\firefly-buddy-mcp.exe"

窓は tkinter(Python に同梱)で出します。今のところ Windows で動作を確かめています。

ffmpeg は PATH にあればそれを、無ければ imageio-ffmpeg の同梱版を使う。

環境変数(任意):

変数

内容

FIREFLY_BUDDY_HOME

依頼・結果を置く場所(既定 ~/.firefly-buddy-mcp)

FIREFLY_BUDDY_DOWNLOADS

見張るフォルダ(既定は Windows の「ダウンロード」)

FIREFLY_BUDDY_WATCH_EXT

見張る拡張子(既定 .wav。例 .wav,.zip。音声・動画・zip 以外は無視)

FIREFLY_BUDDY_FFMPEG

ffmpeg の場所

テスト

.venv\Scripts\python -m unittest discover -s tests

窓(tkinter)と Firefly そのものは、テストでは動かさない。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers