🎙️ Podbean MCP Server 🎧

🎙️ Podbean MCP サーバー 🎧

Podbean API を通じてポッドキャストを管理するための MCP サーバーです。

🎉 概要

この MCP サーバーは、MCP 対応のあらゆる AI アシスタントを Podbean API に接続します。Cline（IDE MCP クライアント）、Claude Desktop、その他の MCP クライアントのいずれを使用していても、自然な会話を通じてポッドキャスト、エピソード、分析データを管理できます。

✨ 機能

🔐 認証

• 自分のポッドキャストを管理するためのクライアント認証
• 必要に応じたサードパーティアクセス用の OAuth フロー
• 複数のポッドキャストのトークン管理。すべてまとめて管理できます！

🎙️ ポッドキャスト管理

• すばらしいポッドキャストをすべて一か所で一覧表示
• 番組の詳細情報を確認
• 統計や分析データをチェック（誰が聴いているのでしょうか？）
• ポッドキャストのカテゴリを閲覧して、自分に合った分野を探す

📝 エピソード管理

• ポッドキャストの全エピソードを一覧で確認
• エピソードの詳細を確認
• 新しいエピソードを簡単に公開（複雑なフォームは不要です！）
• 必要に応じて既存のエピソードを更新
• 期待どおりでなかったエピソードを削除

📁 ファイル管理（限定的）

• Podbean へのファイルアップロードに必要な認証情報を取得（署名付き URL）
• 注記： STDIO プロトコルの制限により、このサーバーからファイルを直接アップロードすることはできません
• サーバーは必要な認証情報とファイルキーを提供しますが、実際のファイルアップロードは外部で行う必要があります

📊 分析

• ポッドキャストのダウンロード数を確認
• 毎日のリスナー数を追跡（増加を見守りましょう！）
• ユーザーがコンテンツをどのように利用しているかを確認

🌐 公開ポッドキャストへのアクセス

• oEmbed を通じて公開ポッドキャストのデータにアクセス
• 公開されているあらゆるエピソードの情報を取得

🧰 前提条件

• Python 3.10 以降（まだアップグレードしていない場合は、そろそろアップグレードしましょう！）
• API にアクセスできる Podbean アカウント（無料・有料のどちらでも歓迎です）
• Podbean API の認証情報（Client ID と Secret。王国への魔法の鍵です）

🚀 インストール

Smithery 経由でのインストール

Smithery を使って、Claude Desktop 用の Podbean Podcast Manager を自動的にインストールするには：

npx -y @smithery/cli install @amurshak/podbeanmcp --client claude

1. コードを取得します：

   git clone <repository-url>
   cd PodbeanMCP
   

2. 高速な uv ツールを使って仮想環境をセットアップします：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. パッケージと依存関係をインストールします：

   # Using uv (faster)
   uv pip install -e .
   

   従来の pip を使う場合は、次のコマンドを実行します：

   pip install -e .
   

   これにより、以下を含む pyproject.toml ファイル内のすべての依存関係がインストールされます：

   • mcp[cli]（MCP SDK）
   • httpx（API リクエスト用）
   • python-dotenv（環境変数用）
   • pydantic（データ検証用）

4. Podbean の秘密の力を設定した .env ファイルを作成します：

   PODBEAN_CLIENT_ID=your_client_id
   PODBEAN_CLIENT_SECRET=your_client_secret
   

📝 cline_mcp_settings.json での設定

この MCP サーバーの推奨される使用方法は、cline_mcp_settings.json ファイルに直接設定することです。これにより、必要に応じて Cline IDE MCP クライアントがサーバーを自動的に起動できます。

1. cline_mcp_settings.json ファイルを見つけます。このファイルは、Cline IDE で MCP サーバーを設定するために使用されます。お使いのシステム上でのファイルの正確な場所については、Cline IDE のドキュメントを参照してください。

2. "mcpServers" オブジェクトに Podbean MCP サーバーの設定を追加します：

{
  "mcpServers": {
    "Podbean MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/full/path/to/PodbeanMCP/server.py"
      ],
      "env": {
        "PODBEAN_CLIENT_ID": "your_client_id",
        "PODBEAN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

3. 設定をカスタマイズします：

   • /full/path/to/PodbeanMCP/server.py を server.py ファイルの絶対パスに置き換えます
   • your_client_id と your_client_secret を .env ファイルに記載した Podbean API の認証情報に置き換えます
   • uv を使用していない場合は、コマンドと args を適宜調整します

4. ファイルを保存し、Cline IDE を再起動します

重要な注記：この設定を使用する場合、python server.py でサーバーを手動起動する必要はありません。必要に応じて Cline IDE がサーバーを自動的に起動し、Claude（AI）がアクセスできるようになります。

複数のサーバーを設定する例

設定にすでに他の MCP サーバーがある場合は、新しいエントリとして Podbean MCP サーバーを追加するだけです：

{
  "mcpServers": {
    "Some Other MCP": {
      "command": "...",
      "args": [
        "..."
      ]
    },
    "Podbean MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/full/path/to/PodbeanMCP/server.py"
      ],
      "env": {
        "PODBEAN_CLIENT_ID": "your_client_id",
        "PODBEAN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

🧪 インストールのテスト

cline_mcp_settings.json ファイルで MCP サーバーを設定したら、Claude に Podbean MCP ツールのいずれかを使うよう依頼して、正常に動作するかテストできます。

1. Podbean で認証する：

   Can you authenticate with my Podbean account using the Podbean MCP server?
   

2. ポッドキャストの一覧を取得する：

   Can you list my podcasts using the Podbean MCP server?
   

3. 特定のポッドキャストのエピソードを取得する：

   Can you get the episodes for my podcast with ID "your_podcast_id" using the Podbean MCP server?
   

Claude がこれらのコマンドを正常に実行し、期待どおりの結果を返したら、Podbean MCP サーバーは正しく動作しています！

🔧 利用可能なツール

🔑 認証ツール

• authenticate_with_podbean()：Podbean の VIP バックステージパスを取得します
• get_podcast_tokens()：ポケモンのように、すべてのポッドキャストのトークンを集めます
• get_podcast_token(podcast_id)：特別なポッドキャスト専用のトークンを取得します

🎙️ ポッドキャストツール

• list_podcasts_tool()：ポッドキャストの帝国を一覧で確認します
• get_podcast_info()：ポッドキャストの詳しい情報を取得します
• get_podcast_stats(podcast_id, start_date, end_date, period, episode_id)：数値やグラフ、自慢できる材料を確認できます！
• get_daily_listeners(podcast_id, month)：日ごとに増えていくリスナーを追跡します
• browse_podcast_categories()：カテゴリ別にポッドキャストの世界を探索します

🎧 エピソードツール

• get_podcast_episodes_tool(podcast_id)：番組のエピソードをすべて集めます
• get_episode_details_tool(episode_id)：特定のエピソードを詳しく確認します
• publish_episode(podcast_id, title, content, ...)：あなたの声を世界に届けましょう！
• update_episode(episode_id, podcast_id, ...)：エピソードを完璧に仕上げましょう
• delete_episode(episode_id, podcast_id, delete_media)：おっと！これは削除が必要です……

💾 ファイル認証ツール（制限あり）

• authorize_file_upload(podcast_id, filename, filesize, content_type)：ファイルをアップロードする許可を取得します
• upload_file_to_podbean(presigned_url, file_path, content_type, file_key)：注：これはファイルのアップロードをシミュレートするプレースホルダー関数です。STDIO プロトコルの制限により、実際にファイルを転送することはありません

🌐 パブリックアクセスツール

• get_oembed_data(url)：Podbean の URL から埋め込み用データを取得します
• get_public_episode_info(episode_url)：公開エピソードをチェックします（もちろん合法的に！）

🔗 OAuth ツール（サードパーティアクセス用）

• generate_oauth_url(redirect_uri, scope, state)：ログイン用の魔法のリンクを作成します
• exchange_oauth_code(code, redirect_uri)：認可コードを交換して、新しいトークンを取得します
• refresh_oauth_token(refresh_token)：期限切れのトークンを更新します。順番待ちは不要です！

📚 利用可能なリソース

• podbean://auth：認証情報の宝箱
• podbean://podcast/{podcast_id}：ポッドキャストのエピソード集
• podbean://episode/{episode_id}：エピソードの詳細情報
• podbean://upload/authorize：アップロード許可証（実際のアップロードはできません）
• podbean://categories：ポッドキャストカテゴリの百科事典
• podbean://public/oembed：Podbean の URL 用の埋め込み対応データ
• podbean://oauth/authorize：OAuth 認可ゲートウェイ

💬 利用可能なプロンプト

• podcast_summary(podcast_id)：「AI、私のポッドキャストを要約してくれる？」
• episode_transcript(episode_id)：「私のとりとめない話を、読みやすい文章にして！」

💬 任意の MCP クライアントでの使用例

この MCP サーバーを使って、AI アシスタントとやり取りする楽しい方法をご紹介します。

1. VIP パスを取得する：

   Hey, can you authenticate with my Podbean account and show me my podcast collection?
   

2. エピソードを集める：

   I'm feeling nostalgic! Show me all the episodes from my "Cooking with Code" podcast.
   

3. あなたの才能を世界に届ける：

   I'm ready to drop a new episode! It's called "AI in Podcasting" and it's all about how AI is making podcasting easier and more fun. Can you help me publish it?
   

4. 誰かが聴いているか確認する 👂：

   How's my podcast doing? Can you show me the download stats from last week?
   

🛠️ エラー処理

うまくいかないときもお任せください！このサーバーには、とても親切なエラー処理が備わっています。

• 認証でつまずきましたか？修正方法をご案内します 🔧
• API で問題が起きましたか？何が起きたのかを正確にお知らせします 🚨
• 正しく処理できない操作を試しましたか？問題が起きる前にお知らせします 🤓
• 人にもわかりやすい、詳細なエラーメッセージを表示します！ 😮‍💨

🚧 制限事項

• ファイルのアップロード：STDIO プロトコルの制限により、このサーバーは Podbean にファイルを直接アップロードできません。必要な認証情報（署名付き URL）とファイルキーは取得できますが、実際のファイル転送は外部ツールまたはプロセスで行う必要があります。
• 一部の高度な機能には、有料の Podbean サブスクリプションが必要な場合があります 💳
• Podbean にはレート制限があるため、リクエストを送りすぎないでください 🚀
• ポッドキャストのコンテンツをバズらせることはできません（それは皆さん次第です！）🌟

👩‍💻 コントリビューション

もっと良くするアイデアをお持ちですか？ぜひご協力ください！フォークして、コードを書き、プルリクエストを送ってください。一緒にポッドキャスト管理をさらに素晴らしいものにしましょう！🤝

📃 ライセンス

[お好みのライセンスを記入してください。可能であればオープンソースのものをお選びください！]

👏 謝辞

• Podbean API ドキュメントを作成してくださった素晴らしい皆さん 📖
• MCP SDK を作成した魔法使いの皆さん 🧙‍♂️
• このツールを使って素晴らしいポッドキャストを作ってくださる皆さん 🎉