infinitimeless/podcrawler-mcp
If you are the rightful owner of podcrawler-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
PodCrawlerMCP is a Model Context Protocol server designed for podcast discovery through web crawling, enabling AI assistants to find podcast episodes on specific topics by crawling the web for RSS feeds.
PodCrawlerMCP
An MCP (Model Context Protocol) server for podcast discovery through web crawling. PodCrawlerMCP enables AI assistants to find podcast episodes on specific topics by crawling the web for RSS feeds.
Features
- ๐ธ๏ธ Crawls podcast directories to discover RSS feeds
- ๐๏ธ Parses RSS feeds to extract episode data
- ๐ Filters episodes by topic or domain
- ๐ Exposes functionality through MCP tools
- ๐ค Seamlessly integrates with AI assistants like Claude
Installation
pip install podcrawler-mcp
Or with Poetry:
poetry add podcrawler-mcp
Quick Start
Run the server directly:
python -m podcrawler.server
Or in your Python code:
from podcrawler import PodCrawlerServer
server = PodCrawlerServer()
server.run()
Integrating with Claude Desktop
Add to your Claude Desktop configuration:
{
"mcpServers": {
"podcrawler": {
"command": "python",
"args": ["-m", "podcrawler.server"]
}
}
}
Available Tools
discover_podcasts
Discovers podcasts on a specific topic.
Parameters:
topic(string): The topic to search for (e.g., "technology", "history")max_results(integer, optional): Maximum number of results to return (default: 10)
Example Usage:
What are some science podcasts about black holes?
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 components
โ โ โโโ __init__.py
โ โ โโโ spider.py # Web crawler implementation
โ โ โโโ parser.py # RSS feed parser
โ โโโ utils/ # Utility functions
โ โโโ __init__.py
โ โโโ filtering.py # Topic filtering utilities
โ โโโ formatting.py # Output formatting utilities
โโโ 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 guidelines
Development
-
Clone the repository
git clone https://github.com/infinitimeless/podcrawler-mcp.git cd podcrawler-mcp -
Install dependencies using Poetry
poetry install -
Run tests
poetry run pytest
Contributing
Contributions are welcome! Please see for details.
License
This project is licensed under the MIT License - see the file for details.
