Apple Podcast

A lightweight and efficient MCP server for searching and retrieving podcast information from the Apple iTunes Store API.

🛠️ Available Tools

The server exposes the following tools via the MCP interface:

• search_podcasts(podcast_name: str, max_results: int = 5)

  Searches for podcasts by name and returns a list of matching results.

• search_podcast_episodes(search_query: str, limit: int = 5)

  Searches for podcast episodes using a query term. For best results, include the podcast name in the query.

📋 Requirements

• Python 3.12+
• uv
• Docker (Optional)

🚀 Getting Started

Installation

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/podcast-transcript-mcp-server.git
   cd podcast-transcript-mcp-server
   

2. Install dependencies:

   uv sync
   

Running the Server

• Development Mode

  To run the server with a live inspector for development, use:

  uv run mcp dev src/server.py
  

• Production Mode

  To run the server for production, use:

  uv run src/server.py
  

🐳 Docker

You can also run the server within a Docker container.

1. Build the image:

   docker build -t apple-podcast-mcp-server .
   

2. Run the container:

   docker run --rm -it -p 8000:8000 apple-podcast-mcp-server