Podcast Index MCP Server

---

上のデモに表示されている結果はサンプルデータであり、実際の Podcast Index の応答ではありません。

概要

Conor Bronsdon が、Chain of Thought のポッドキャスト制作ワークフロー向けに開発・保守しています。リサーチ中にゲストの出演情報を提示し、フィードの健全性を確認できます。Conor は、AI インフラストラクチャと、実務者が実際にそれを使ってどのように構築しているかを扱う番組、Chain of Thought のホストです。クリエイター向けのその他のツールは ai-tools-for-creators にあります。X では @ConorBronsdon をフォローしてください。

連携ツール：

• Transistor MCP：Transistor.fm 公式の MCP サーバーです。エピソード、配信、分析に対応しています。
• substack-mcp：投稿の閲覧と Substack の下書き管理
• op3-mcp：OP3 からダウンロード数、リスナーの地域、アプリをレポート
• apple-podcasts-mcp：Apple Podcasts Connect から再生数、フォロワー数、エピソードごとの再生状況を取得
• gsc-mcp：Google Search Console で検索パフォーマンス、キーワード、サイトマップを照会
• podcast-benchmark：公開データのみを使って、番組を同業の番組と比較

前提条件

• Node.js 18+
• 無料の Podcast Index API 認証情報 — api.podcastindex.org で取得できます

インストール

git clone https://github.com/conorbronsdon/podcastindex-mcp.git
cd podcastindex-mcp
npm install
npm run build

設定

Claude Desktop

Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "podcastindex": {
      "command": "node",
      "args": ["/path/to/podcastindex-mcp/build/index.js"],
      "env": {
        "PODCASTINDEX_API_KEY": "your-api-key",
        "PODCASTINDEX_API_SECRET": "your-api-secret"
      }
    }
  }
}

Claude Code

プロジェクトの .mcp.json に追加します：

{
  "mcpServers": {
    "podcastindex": {
      "command": "node",
      "args": ["/path/to/podcastindex-mcp/build/index.js"],
      "env": {
        "PODCASTINDEX_API_KEY": "your-api-key",
        "PODCASTINDEX_API_SECRET": "your-api-secret"
      }
    }
  }
}

ツール

このサーバーは完全に読み取り専用です。すべてのツールでMCPのツールアノテーション readOnlyHint: true が宣言されているため、クライアントはどの呼び出しでも変更が行われないことを認識し、書き込み許可の確認を省略できます。

ツール	説明
search_by_person	人物がホストまたはゲストとして出演したエピソードを検索します。インデックス内のすべてのポッドキャストから一致するものを返します。
search_by_term	トピック、番組名、キーワードを指定して、すべてのポッドキャストを全文検索します。
search_by_title	タイトルでポッドキャストを検索します。
podcast_by_feed_url	RSSフィードURLからポッドキャストを検索します。フィードID、iTunes ID、カテゴリ、最終更新日時、フィードの健全性を返します。
podcast_by_feed_id	Podcast IndexのフィードIDからポッドキャストを検索します。すべてのメタデータを返します。
podcast_by_itunes_id	Apple Podcasts（iTunes）IDからポッドキャストを検索します。
podcast_by_guid	podcast:guid タグの値からポッドキャストを検索します。
trending_podcasts	現在トレンドのポッドキャストを取得します。言語とカテゴリによる絞り込みも指定できます。
episodes_by_feed_id	フィードIDを指定して、特定のポッドキャストのエピソードを取得します。
episode_by_id	Podcast IndexのエピソードIDから単一のエピソードを検索します。
episodes_live	現在ライブ配信中のエピソードを取得します。
recent_episodes	インデックス全体から、最近公開されたエピソードを取得します。
recent_feeds	インデックス内から、最近更新されたポッドキャストフィードを取得します。
recent_new_feeds	インデックスに新しく追加されたポッドキャストフィードを取得します。
value_by_feed_id	フィードIDを指定して、ポッドキャストのvalue4value（ライトニング決済）情報を取得します。
value_by_feed_url	フィードURLを指定して、ポッドキャストのvalue4value（ライトニング決済）情報を取得します。
categories_list	Podcast IndexのカテゴリとIDの全リストを取得します。
stats_current	Podcast Indexの現在の集計統計情報を取得します。

型付きエラー

APIの失敗は、src/errors.ts にある型付きエラー階層（基底クラスの PodcastIndexError と、HTTPステータスに応じたサブクラスの AuthenticationError、RateLimitError、ValidationError、NotFoundError、ServerError）にマッピングされます。失敗時のツール呼び出しは、引き続き同じ isError: true のレスポンス形式を返します。型付きの階層により、単一の汎用的な「API error」という文字列ではなく、何が問題だったのか（認証情報の誤り、レート制限、リクエストの形式不正など）に応じた具体的なメッセージが表示されます。

プロンプトの例

設定が完了すると、Claudeに次のような質問ができます。

• 「Podcast Indexで、Satya Nadellaがゲストとして出演したすべてのエピソードを検索して」
• 「現在トレンドのテクノロジーポッドキャストは何ですか？」
• 「https://feeds.transistor.fm/chain-of-thought のフィードの健全性を調べて、最新の5つのエピソードを一覧にして」

開発

プロジェクトをビルドします。

npm run build

開発中に変更を監視します。

npm run watch

新しいツールの追加

1. src/api-client.ts にAPIメソッドを追加します
2. src/types.ts に型ガードと引数の型を追加します
3. src/tool-handlers.ts にツールの定義とハンドラーを追加します
4. npm run build で再ビルドします

コントリビューション

Issueやプルリクエストを歓迎します。ツールとして公開してほしいPodcast Indexのエンドポイントがある場合は、ユースケースを説明するIssueを作成するか、上記の手順に従ってPRを作成してください。バグを報告する際は、ツール名と渡した引数を含めてください。

謝辞

このサーバーは、無料でオープンなPodcast Index APIとそのドキュメントのおかげで実現しています。ここにあるツールはすべて、そのAPIを薄くラップしたものです。

このリリースでエンドポイントの対応範囲を拡大し、型付きエラーを設計するにあたっては、同じAPI向けの先行MCPサーバーであるCraig Lawtonのpodcastindex-mcp-serverから着想を得ました。このプロジェクトのコードは使用していません。このサーバーの実装、ツールスキーマ、エラー処理コードは、公式APIドキュメントに基づいて独自に作成しました。

---

免責事項

これは個人による独立したプロジェクトであり、いかなる企業とも提携、支援、または承認を受けていません。ここに記載されている見解はすべて、私個人のものです。

ライセンス

MIT