apple-podcast-mcp-server

oscargullberg/apple-podcast-mcp-server

3.1

If you are the rightful owner of apple-podcast-mcp-server 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.

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

Tools
2
Resources
0
Prompts
0

Apple Podcast MCP Server

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

🚀 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