🎙️ 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 播客管理器：

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. 创建 .env 文件，填入你的 Podbean 密钥：

   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. 将 Podbean MCP 服务配置添加到 "mcpServers" 对象中：

{
  "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 有速率限制，所以不要发送过多请求 🚀
• 我们无法让你的播客内容走红（这还得靠你自己！）🌟

👩‍💻 参与贡献

有让它变得更好的想法吗？我们很期待你的帮助！Fork、编写代码，然后向我们发送 Pull Request。让我们携手打造更棒的播客管理体验！🤝

📃 许可证

[在此填写你喜欢的许可证——如果可以，请选择开源许可证！]

👏 致谢

• Podbean API 文档背后的杰出团队 📖
• 创建 MCP SDK 的高手们 🧙‍♂️
• 感谢你使用此工具制作精彩的播客！🎉