Fireside.fm (unofficial)

firesidefm-mcp-server

Fireside.fmのポッドキャストホスティング API 用のMCPサーバーです。Claude Code や Claude Desktop などの MCP ホストから、ポッドキャスト、エピソード、ダウンロード統計を読み取ったり、エピソードの作成、編集、公開、公開停止を行ったり、エピソードの音声、カバーアート、文字起こしをアップロードしたりできます。

これは非公式のプロジェクトです。Fireside との提携や承認は受けていません。

必要条件

• Node.js 22 以降
• https://app.fireside.fm/api_tokensで作成した Fireside API キー

読み取り専用キーでは読み取りツールが利用でき、読み取り／書き込みキーではエピソードを変更するツールも利用できます。アシスタントにエピソードを作成、編集、公開させる場合を除き、読み取り専用キーを使用してください。キーは Fireside アカウント内のすべてのポッドキャストに適用されます。キーは「アカウント」>「API キー」で読み取り専用と読み取り／書き込みの間で切り替えられます。サーバーは起動時に利用可能なツールを決定するため、切り替えた後はサーバーを再起動してください。

設定

変数	必須	意味
FIRESIDE_API_TOKEN	はい	Fireside API キー（fire_…）。
FIRESIDE_PODCAST	いいえ	リクエストでポッドキャストが指定されていない場合に使用する、ポッドキャストのトークンまたはスラッグ。
FIRESIDE_READ_ONLY	いいえ	trueにすると、読み取り／書き込みキーを使用していても読み取りツールのみを提供します。
FIRESIDE_UPLOAD_DIRS	いいえ	アップロード可能なファイルを含むディレクトリ。PATHと同じ区切り文字で指定します（macOS と Linux では:、Windows では;）。絶対パスを指定します。先頭の~/はホームディレクトリを表します。設定されていない場合、アップロードは無効です。

起動時に、サーバーは Fireside でキーを確認します。書き込みツールは、キーが読み取り／書き込みであり、FIRESIDE_READ_ONLYが設定されていない場合にのみ提供されます。キーが拒否されると、サーバーは標準エラー出力に説明を表示して停止します。ネットワークエラーや Fireside の障害など、その他の理由でキーを確認できない場合、サーバーは読み取りツールのみで起動し、その理由を標準エラー出力に表示します。再試行するにはサーバーを再起動してください。

fireside_upload_fileは、読み取り／書き込みキーを使用し、FIRESIDE_UPLOAD_DIRSが設定されている場合にのみ提供されます。指定したディレクトリ内のファイルのみを送信します（確認の前にシンボリックリンクをたどり、ファイルを開いた後にも確認を繰り返します。ハードリンクはリンク先のファイルと区別できず、別のプログラムが同時にこれらのディレクトリを書き換えると、確認と競合する可能性があります）。そのため、ホームディレクトリではなく、完成したエピソードファイルを保存しているフォルダーを設定してください。

以下のどちらのホストも、設定ファイルにキーを平文で保存します。

Claude Code

claude mcp add fireside \
  --env FIRESIDE_API_TOKEN=fire_… \
  --env FIRESIDE_PODCAST=your-podcast-slug \
  -- npx -y firesidefm-mcp-server

これにより、現在のプロジェクトだけにサーバーが追加されます。すべてのプロジェクトで利用できるようにするには、--scope userを追加してください。

Claude Desktop

Claude Desktop の設定ファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

mcpServersの下にエントリーを追加します（ファイルにまだオブジェクトがない場合は作成してください）。

{
  "mcpServers": {
    "fireside": {
      "command": "npx",
      "args": ["-y", "firesidefm-mcp-server"],
      "env": {
        "FIRESIDE_API_TOKEN": "fire_…",
        "FIRESIDE_PODCAST": "your-podcast-slug"
      }
    }
  }
}

その後、Claude Desktop を終了して再度開いてください。

Claude Desktop はシェルのプロファイルを読み込まないため、nvm などのバージョンマネージャーを使って Node をインストールした場合、npxが見つからないことがあります。その場合は、which npxで表示されるフルパスを"command"に設定してください。

ツール

ポッドキャストとエピソードは、トークンまたはスラッグで指定できます。エピソードのスラッグは、ダッシュボードでカスタマイズされていない限り、エピソード番号がデフォルトで使われます。そのため、「episode 42」のように指定できます（例：s02e04）。

ツール	読み取り／書き込みキーが必要	機能
fireside_get_account		接続中のアカウントと、そのキーが読み取り専用か読み取り／書き込み可能かを確認します。
fireside_list_podcasts		所有または共同制作しているポッドキャストを一覧表示します。
fireside_get_podcast		1つのポッドキャストの詳細と累計ダウンロード数を取得します。
fireside_list_episodes		最新順にエピソードを一覧表示します。下書きと予約済みのものも含まれ、ステータスで絞り込めます。
fireside_get_episode		ショーノートを含む、1つのエピソードのすべてのフィールドを取得します。
fireside_get_episode_metrics		エピソードごとの1、7、14、30、90日間のダウンロード数、Spotifyのダウンロード数、合計を取得します。
fireside_get_monthly_downloads		暦月ごとのダウンロード数と累計を取得します。
fireside_get_daily_downloads		ポッドキャストまたは1つのエピソードの日ごとのダウンロード数を取得します。Spotifyのダウンロード数は別に集計され、1回の呼び出しで最大1年分を取得できます。
fireside_create_episode	✓	音声、カバーアート、トランスクリプトを付けて、非公開の下書きエピソードを作成します（いずれも任意です）。
fireside_update_episode	✓	タイトル、サブタイトル、スラッグ、ショーノート、シーズン、種別、露骨な表現のフラグ、音声、カバーアート、トランスクリプトを変更します。
fireside_upload_file	✓	FIRESIDE_UPLOAD_DIRSからMP3、カバー画像（JPG、PNG、GIF、WebP）、またはプレーンテキストのトランスクリプトをアップロードし、エピソードに添付するか、作成・更新用のfile_urlを返します。
fireside_publish_episode	✓	今すぐ公開、公開を予約、または過去の日付で公開します。公開範囲は一般公開または限定公開にできます。
fireside_unpublish_episode	✓	エピソードを非公開の下書きに戻します。

fireside_get_episodeには、エピソードのプレビューリンクが含まれます。このリンクを持っている人は、公開前でもエピソードを再生できます。

MP3をアップロードする前に、サーバーはヘッダーを読み取ります。MP3音声が含まれていないファイル（WAVの名前を変更したファイルなど）は拒否されます。FiresideダッシュボードがMP3に推奨する設定（モノラル、64～96 kb/s、44.1 kHz）と異なるファイルは、相違点の一覧とともにアップロードが停止されます。アシスタントはユーザーに確認したうえで、accept_audio_specs: trueの場合に限り、そのままアップロードします。音声の上限はFiresideのプランによって異なり、APIからは確認できません。Firesideはデータ送信前にファイルサイズを確認し、サーバーはサイズが原因として考えられることを伝えます。

アップロードされた音声はバックグラウンドでエピソードに転送されます。エピソードのaudio_statusには、処理中はprocessing、完了または失敗時にはreadyまたはfailed（audio_error付き）が表示されます。カバーアートとトランスクリプトは呼び出し中に添付されます。大きな音声ファイルのアップロードには、MCPホストがツール呼び出しに許可する時間を超える時間がかかる場合があります。Claude Codeでは、MCP_TOOL_TIMEOUT環境変数（ミリ秒）で上限を引き上げられます。

制限事項

以下はFireside API自体による制限です。

• API経由でチャプターをアップロードすることはできません。音声なしでエピソードを公開すると失敗します。
• ファイルはプランの上限内である必要があります。カバーアートは最大1.91 MB、トランスクリプトは最大195 KB、音声はプランのMP3上限以内です。
• エピソードの削除や、ポッドキャスト設定の変更はできません。
• ダッシュボードでエピソードの公開時にポッドキャストの連携済みソーシャルアカウントにも投稿する設定になっている場合、公開時にそちらにも投稿されます。APIからこの設定を確認・変更することはできません。
• 日ごとのダウンロード数は、1回のリクエストで最大90日分まで取得できます。サーバーが複数のリクエストをまとめるため、1回の呼び出しで最大1年分を取得できます。より長い期間は分割してリクエストしてください。
• リクエスト数はキーごとに毎分120回までです。サーバーは短時間のレート制限による待機を解消し、長時間の場合はその旨を通知します。

開発

npm install
npm run build       # compiles to dist/
npm run typecheck
npm test            # unit and in-process MCP tests; no network
npm run test:e2e    # builds, then runs dist/cli.js over stdio against a local stand-in API
npm run check       # all of the above
npm run dev         # run from source with tsx

scripts/には、macOSキーチェーンから読み込んだキーを使って実際のFireside APIに対して実行するチェックが2つあります。各ファイルの先頭にあるコメントを参照してください。live-read-check.tsは読み取りのみを行います。live-draft-check.tsは下書きエピソードを1つ作成・編集します。作成されたエピソードはダッシュボードで削除してください。このスクリプトは公開または非公開化のリクエストを送信しません。

ライセンス

MIT