🎙️ Podbean MCP服务器🎧
MCP服务器，用于通过Podbean API管理您的播客。
🎉 概述
此MCP服务器将任何兼容MCP的AI助手连接到Podbean API。无论您是使用Cline（IDE MCP客户端）、Claude Desktop还是任何其他MCP客户端，您现在都可以通过自然对话来管理您的播客、剧集和分析！
✨ 特性
🔐 认证
- 用于管理您自己的播客的客户端凭据身份验证
- 用于第三方访问的OAuth流（需要时）
- 多个播客的令牌管理-兼顾所有播客！
🎙️ 播客管理
- 在一个地方列出你所有很棒的播客
- 了解你的节目的细节
- 查看你的统计数据和分析（谁在听？）
- 浏览播客类别以找到您的细分市场
📝 事件管理
- 浏览播客的所有剧集
- 深入了解任何一集的细节
- 轻松发布新剧集（无需更复杂的表单！）
- 需要调整时更新现有剧集
- 删除不太符合要求的剧集
📁 文件管理（有限）
- 获取文件上传到Podbean的授权（预签名URL）
- 注： 由于STDIO协议的限制，此服务器无法直接上传文件
- 服务器提供必要的授权和文件密钥，但实际的文件上传必须由外部处理
📊 分析
- 查看您的播客下载量
- 跟踪你每天的听众数量（看着他们增长！）
- 查看用户如何与您的内容交互
🌐 公共播客访问
- 通过oEmbed访问公共播客数据
- 获取任何公开事件的独家新闻
🧰 先决条件
- Python 3.10或更高版本（如果你还没有升级，是时候升级了！）
- 具有API访问权限的Podbean帐户（免费或付费-欢迎使用）
- Podbean API证书（客户ID和秘密-王国的神奇钥匙）
🚀 安装
通过Smithery安装
通过以下方式自动安装克劳德桌面版Podbean播客管理器 史密瑟里:```bash
npx -y @smithery/cli install @amurshak/podbeanmcp --client claude
1. 获取代码：```bash
git clone
cd PodbeanMCP
- 使用超高速设置虚拟环境
uv工具：```bash
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
1. 安装软件包及其依赖项：```bash
# Using uv (faster)
uv pip install -e .
或者，如果你更喜欢传统的pip：```bash
pip install -e .
这将安装pyproject.toml文件中的所有依赖项，包括：
- mcp\cli\
- httpx（用于API请求）
- python dotenv（用于环境变量）
- pydantic（用于数据验证）
1. 创建一个 `.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客户端在需要时自动启动服务器。
-
找到您的cline_mcp_settings.json文件。Cline IDE使用此文件配置MCP服务器。有关此文件在系统上的确切位置，请参阅Cline IDE文档。
-
将Podbean MCP服务器配置添加到“mcpServers”对象中：```json
{
"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`，相应地调整命令和参数
1. 保存文件并重新启动Cline IDE
> **重要提示**：您不需要手动运行服务器 `python server.py` 当使用此配置时。Cline IDE将在需要时自动启动服务器，Claude（AI）将能够访问它。
### 多服务器示例
如果您的配置中已经有其他MCP服务器，只需将Podbean MCP服务器添加为新条目：```json
{
"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工具之一来测试它是否正常工作：
- 使用Podbean进行身份验证:```
Can you authenticate with my Podbean account using the Podbean MCP server?
1. **列出您的播客**:```
Can you list my podcasts using the Podbean MCP server?
- 获取特定播客的剧集:```
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()`：在播客中获取411
- `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?
- 总结这些剧集:```
I'm feeling nostalgic! Show me all the episodes from my "Cooking with Code" podcast.
1. **与世界分享你的才华**:```
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?
- 检查是否有人在听 👂:
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的向导🧙♂️
- 感谢您使用此工具制作出色的播客！ 🎉
