firefly-buddy-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 から落とした元のファイルは残る)。
ツール
ツール | 内容 |
| 効果音をまとめて頼む(1 回 12 件まで)。すぐ |
| 受け取りの状況。 |
| ファイルを手で渡す(コピーして変換する) |
| 待っている項目を取り消す |
項目(items の 1 つ):
キー | 内容 |
| できたファイルの名前(拡張子なし)。2 つ目からは |
| Firefly に貼るプロンプト。英語だけ(Firefly の効果音は英語しか受け付けない)、750 字まで |
| 人間向けの日本語のメモ(何に使うか・どんな音なら当たりか) |
| 長さ(秒、30 まで)。窓に「Duration を ◯ 秒に」と出る。Firefly の Duration は 1〜30 秒・0.1 秒刻みで既定が 8 秒。一発の音もそのままだと 8 秒の地鳴りになるので必ず付ける。届いた案の長さが 0.3 秒以上ずれていたら、受け取ったうえで注意を出す |
| 入れる先(絶対パス)。省略すると |
| 4 案のうち何案まで残すか(1〜4) |
|
|
| 頭の無音を切る(既定 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 の同梱版を使う。
環境変数(任意):
変数 | 内容 |
| 依頼・結果を置く場所(既定 |
| 見張るフォルダ(既定は Windows の「ダウンロード」) |
| 見張る拡張子(既定 |
| 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
CC0 sound effects API for AI agents — search, preview, and download via MCP.
Generate sound effects and music from text for games, apps and videos. Returns audio file URLs.
Turn Claude into a creative studio: DNA-locked characters, images, video, voiceover — 55 tools.
Related MCP Servers
- AlicenseBqualityDmaintenanceGenerates sound effects from text descriptions using ElevenLabs API and saves them as MP3 files.11MIT
- AlicenseNot gradedqualityCmaintenanceEnables automated sound design spotting from Claude Code: analyze video, generate cue sheets, search or generate SFX, and export DAW-synchronized stems.6 npmMIT
- AlicenseAqualityCmaintenanceEnables Claude Desktop to generate Gemini text-to-speech audio, save .wav files locally, and manage generated audio files through MCP tools.2ISC
- AlicenseAqualityBmaintenanceEnables users to describe a sound in plain words inside Claude and receive a generated audio file saved in their project. Supports synthesizing wind, whooshes, creaks, impacts, rain and UI blips, plus seamless loops, layered scenes, varied output formats, loudness targets, and conversion or trimming of existing audio files.6MIT