PodCrawlerMCP

一个通过网络爬取进行播客发现的 MCP (模型上下文协议) 服务器。 PodCrawlerMCP 使 AI 助手能够通过爬取网络上的 RSS 订阅源来查找特定主题的播客剧集。

特性

• 🕸️ 爬取播客目录以发现 RSS 订阅源
• 🎙️ 解析 RSS 订阅源以提取剧集数据
• 🔍 按主题或领域过滤剧集
• 🔌 通过 MCP 工具公开功能
• 🤖 与 Claude 等 AI 助手无缝集成

安装

pip install podcrawler-mcp

或者使用 Poetry:

poetry add podcrawler-mcp

快速开始

直接运行服务器：

python -m podcrawler.server

或者在你的 Python 代码中：

from podcrawler import PodCrawlerServer

server = PodCrawlerServer()
server.run()

与 Claude Desktop 集成

添加到你的 Claude Desktop 配置中：

{
  "mcpServers": {
    "podcrawler": {
      "command": "python",
      "args": ["-m", "podcrawler.server"]
    }
  }
}

可用工具

discover_podcasts

发现特定主题的播客。

参数：

• topic (字符串): 要搜索的主题 (例如, "技术", "历史")
• max_results (整数, 可选): 要返回的最大结果数 (默认: 10)

使用示例：

有哪些关于黑洞的科学播客？

项目结构

podcrawler-mcp/
├── podcrawler/                # 主包
│   ├── __init__.py            # 包初始化
│   ├── server.py              # MCP 服务器实现
│   ├── tools/                 # MCP 工具
│   │   ├── __init__.py
│   │   └── discovery.py       # 播客发现工具
│   ├── crawler/               # 网络爬取组件
│   │   ├── __init__.py
│   │   ├── spider.py          # 网络爬虫实现
│   │   └── parser.py          # RSS 订阅源解析器
│   └── utils/                 # 实用函数
│       ├── __init__.py
│       ├── filtering.py       # 主题过滤实用程序
│       └── formatting.py      # 输出格式化实用程序
├── tests/                     # 测试
│   ├── __init__.py
│   └── test_server.py         # 服务器测试
├── examples/                  # 使用示例
│   └── basic_discovery.py     # 基本发现示例
├── pyproject.toml             # 项目配置
├── README.md                  # 项目文档
├── LICENSE                    # MIT 许可证
└── CONTRIBUTING.md            # 贡献指南

开发

1. 克隆仓库

   git clone https://github.com/infinitimeless/podcrawler-mcp.git
   cd podcrawler-mcp
   

2. 使用 Poetry 安装依赖

   poetry install
   

3. 运行测试

   poetry run pytest
   

贡献

欢迎贡献！ 请参阅 CONTRIBUTING.md 了解详情。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。