Skip to content
Back to search

firefly-buddy-mcp

Stdio MCP server: Claude asks the human to make sound effects in the Adobe Firefly web app (with their generative credits) through a desktop window, and picks the downloads up as 16-bit WAV into the folder it asked for

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/holmesfems--firefly-buddy-mcp/badge.svg)](/listings/holmesfems--firefly-buddy-mcp)

HTML

<a href="/listings/holmesfems--firefly-buddy-mcp"><img src="/api/listings/holmesfems--firefly-buddy-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 93 lines
  1. # firefly-buddy-mcp
  2. ![テラコッタ色のロボが、波形を描いたカードをヘッドホンの人に手渡し、ホタルが飛ぶ中で効果音のファイルがフォルダに入っていく絵](docs/hero.png)
  3. <sub>この絵は [gemini-buddy-mcp](https://github.com/holmesfems/gemini-buddy-mcp) の `gemini_generate_image`(`backend="agy"`)で作りました。</sub>
  4. Claude が「この効果音を Adobe Firefly で作ってきて」と人間に頼むための MCP サーバー。
  5. Firefly(Web)の生成クレジットを使って効果音を作り、ダウンロードしたファイルを Claude が指定したフォルダへ自動で届ける。
  6. ## なぜ人間に頼むのか
  7. - Firefly の Web アプリのクレジットを使える API は無い(Firefly Services API は企業向けの別契約で、効果音の API も見当たらない)。
  8. - Adobe の生成 AI 利用ガイドラインは、許可のない自動化・スクリプトでの操作を禁じている。ブラウザを自動で操作しない。
  9. - 効果音は当たり外れが大きいので、Firefly が出す 4 案から人間が耳で選ぶ工程は、むしろあったほうがいい。
  10. ## 流れ
  11. ```
  12. Claude ── firefly_request_sfx(英語のプロンプトをまとめて)──▶ デスクトップに窓が出る
  13. 人間 ── 「コピーして受け取り開始」→ Firefly に貼って生成 → 気に入った案をダウンロード
  14. 窓 ── ダウンロードフォルダに届いたファイルを拾い、16bit PCM・48kHz の wav にして dest_dir へ
  15. Claude ── firefly_status で受け取りを確かめる
  16. ```
  17. - 窓は、項目のボタンを押した後に届いた `.wav` だけを拾う(Firefly の効果音は `.wav` で落ちてくる)。それ以外のダウンロードには触らない。
  18. - 同じ中身のファイルは、同じ依頼の中で二度受け取らない(同じ案を二度落とした、受け取ったファイルを手で選び直した、など)。
  19. - 拾ったファイルの元(Firefly から落としたまま)は `~/.firefly-buddy-mcp/originals/<batch_id>/` に移す。
  20. - 拾い漏れたら、窓の「ファイルを選ぶ…」か、Claude の `firefly_attach` で渡せる。
  21. - 間違えて受け取ったファイルは、窓の「取り消す」で取り消せる(受け取り先のファイルを消す。Firefly から落とした元のファイルは残る)。
  22. ## ツール
  23. | ツール | 内容 |
  24. |---|---|
  25. | `firefly_request_sfx` | 効果音をまとめて頼む(1 回 12 件まで)。すぐ `batch_id` を返し、窓を開く |
  26. | `firefly_status` | 受け取りの状況。`wait_seconds`(110 秒まで)で、変化があるまで待てる。`reopen_popup` で窓を開き直す |
  27. | `firefly_attach` | ファイルを手で渡す(コピーして変換する) |
  28. | `firefly_cancel` | 待っている項目を取り消す |
  29. 項目(`items` の 1 つ):
  30. | キー | 内容 |
  31. |---|---|
  32. | `name` | できたファイルの名前(拡張子なし)。2 つ目からは `_2`・`_3` が付く |
  33. | `prompt` | Firefly に貼るプロンプト。**英語だけ**(Firefly の効果音は英語しか受け付けない)、750 字まで |
  34. | `note` | 人間向けの日本語のメモ(何に使うか・どんな音なら当たりか) |
  35. | `duration` | 長さ(秒、30 まで)。窓に「Duration を ◯ 秒に」と出る。Firefly の Duration は 1〜30 秒・0.1 秒刻みで既定が 8 秒。一発の音もそのままだと 8 秒の地鳴りになるので必ず付ける。届いた案の長さが 0.3 秒以上ずれていたら、受け取ったうえで注意を出す |
  36. | `dest_dir` | 入れる先(絶対パス)。省略すると `~/.firefly-buddy-mcp/outbox/<batch_id>/` |
  37. | `want` | 4 案のうち何案まで残すか(1〜4) |
  38. | `convert` | `pcm16`(16bit PCM・48kHz の wav。既定)か `none`(Firefly のファイルのまま) |
  39. | `trim_silence` | 頭の無音を切る(既定 true) |
  40. ## AK Studio の効果音で使う
  41. `dest_dir` を `<回のフォルダ>/fx/se/<種類>`(`chapter`・`slam`・`wipe`・`blip` など)にすると、
  42. AK Studio の「効果音の設定」の候補に自動で並ぶ(AK Studio は 16bit PCM の wav だけ読む)。
  43. どれを鳴らすかは、ユーザーが聞き比べて決める。
  44. ## 入れ方
  45. ```powershell
  46. git clone https://github.com/holmesfems/firefly-buddy-mcp
  47. cd firefly-buddy-mcp
  48. python -m venv .venv
  49. .venv\Scripts\python -m pip install -e .
  50. ```
  51. venv 内の実行ファイルを指定して登録します(パスは clone した場所に合わせてください)。`--scope user` を付けると、どのプロジェクトからも使えます。
  52. ```powershell
  53. claude mcp add firefly-buddy --scope user -- "C:\path\to\firefly-buddy-mcp\.venv\Scripts\firefly-buddy-mcp.exe"
  54. ```
  55. 窓は tkinter(Python に同梱)で出します。今のところ Windows で動作を確かめています。
  56. ffmpeg は PATH にあればそれを、無ければ `imageio-ffmpeg` の同梱版を使う。
  57. 環境変数(任意):
  58. | 変数 | 内容 |
  59. |---|---|
  60. | `FIREFLY_BUDDY_HOME` | 依頼・結果を置く場所(既定 `~/.firefly-buddy-mcp`) |
  61. | `FIREFLY_BUDDY_DOWNLOADS` | 見張るフォルダ(既定は Windows の「ダウンロード」) |
  62. | `FIREFLY_BUDDY_WATCH_EXT` | 見張る拡張子(既定 `.wav`。例 `.wav,.zip`。音声・動画・zip 以外は無視) |
  63. | `FIREFLY_BUDDY_FFMPEG` | ffmpeg の場所 |
  64. ## テスト
  65. ```powershell
  66. .venv\Scripts\python -m unittest discover -s tests
  67. ```
  68. 窓(tkinter)と Firefly そのものは、テストでは動かさない。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.