Podcrawler MCP

🚀 Podcast Crawler MCP Server

A Model Context Protocol (MCP) server for discovering podcasts through web crawling. PodCrawlerMCP enables AI assistants to find podcasts on specific topics by crawling RSS feeds on the web.

🚀 Quick Start

Run the Server Directly

python -m podcrawler.server

Use in Python Code

from podcrawler import PodCrawlerServer

server = PodCrawlerServer()
server.run()

✨ Features

• 🕸️ Crawl podcast directories to discover RSS feeds.
• 🎙️ Parse RSS feeds to extract episode information.
• 🔍 Filter episodes by topic or domain.
• 🔌 Expose functionality through MCP tools.
• 🤖 Seamlessly integrate with AI assistants like Claude.

📦 Installation

Install via pip

pip install podcrawler-mcp

Install via Poetry

poetry add podcrawler-mcp

💻 Usage Examples

Integrate with Claude Desktop

Add the following to your Claude Desktop configuration:

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

discover_podcasts

Discover podcasts by topic.

Parameters:

• topic (string): The topic to search for (e.g., "technology", "history").
• max_results (integer, optional): The maximum number of results to return (default: 10).

Example Usage: What are some science podcasts about black holes?

📚 Documentation

Project Structure

podcrawler-mcp/
├── podcrawler/                # Main package
│   ├── __init__.py            # Package initialization
│   ├── server.py              # MCP server implementation
│   ├── tools/                 # MCP tools
│   │   ├── __init__.py
│   │   └── discovery.py       # Podcast discovery tool
│   ├── crawler/               # Web crawling component
│   │   ├── __init__.py
│   │   ├── spider.py          # Web crawler implementation
│   │   └── parser.py          # RSS feed parser
│   └── utils/                 # Utility functions
│       ├── __init__.py
│       ├── filtering.py       # Topic filtering utility
│       └── formatting.py      # Output formatting utility
├── tests/                     # Tests
│   ├── __init__.py
│   └── test_server.py         # Server tests
├── examples/                  # Usage examples
│   └── basic_discovery.py     # Basic discovery example
├── pyproject.toml             # Project configuration
├── README.md                  # Project documentation
├── LICENSE                    # MIT License
└── CONTRIBUTING.md            # Contribution guide

Development

1. Clone the repository

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

2. Install dependencies using Poetry

poetry install

3. Run tests

poetry run pytest

🤝 Contributing

Contributions are welcome! Please refer to CONTRIBUTING.md for details.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.