Podcrawler MCP

🚀 Podcast爬蟲MCP服務器

一個用於通過網絡爬取發現播客的MCP（模型上下文協議）服務器。PodCrawlerMCP允許AI助手通過爬取網絡上的RSS feed來查找特定主題的播客，為用戶提供便捷的播客搜索體驗。

🚀 快速開始

直接運行服務器

python -m podcrawler.server

在Python代碼中使用

from podcrawler import PodCrawlerServer

server = PodCrawlerServer()
server.run()

✨ 主要特性

• 🕸️ 爬取播客目錄以發現RSS feed
• 🎙️ 解析RSS feed以提取節目信息
• 🔍 根據主題或領域過濾節目
• 🔌 通過MCP工具暴露功能
• 🤖 與Claude等AI助手無縫集成

📦 安裝指南

使用pip安裝

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 feed解析器
│   └── 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

📄 許可證

該項目根據MIT許可證發佈。有關詳細信息，請參閱LICENSE文件。

貢獻

歡迎貢獻！請參閱CONTRIBUTING.md瞭解詳細信息。