Pocket Casts MCP 서버

AI 어시스턴트를 Pocket Casts 계정에 연결하는 MCP 서버입니다. 구독 목록을 탐색하고, 에피소드 세부 정보를 읽고, 대본을 가져올 수 있습니다. 기본 대본이 없는 경우 AssemblyAI를 통해 자동으로 대본을 생성합니다.

Bun과 FastMCP로 구축되었습니다. Railway 또는 모든 Docker 호스트에 배포할 수 있습니다.

도구

Related MCP server: pocketcasts-mcp

설정

사전 요구 사항

• Bun v1.3 이상

• Pocket Casts 계정 (API 액세스를 위해 Plus 필요)

설치 및 인증

bun install
bun run login

로그인 명령을 실행하면 Pocket Casts 이메일과 비밀번호를 묻는 메시지가 표시되며, 이후 토큰이 auth.json에 저장됩니다.

환경 설정

.env 파일을 생성합니다:

MCP_API_KEY=your-secret-key-here
ASSEMBLYAI_API_KEY=your-assemblyai-key    # optional, enables transcription fallback

실행

bun run start

서버는 HTTP 스트림 전송을 사용하여 3001번 포트에서 시작됩니다 (PORT 환경 변수로 재정의 가능).

MCP 클라이언트에 연결

MCP 클라이언트를 다음 주소로 지정하세요:

http://localhost:3001/mcp

다음 중 하나로 인증하세요:

• Authorization: Bearer <MCP_API_KEY> 헤더

• ?api_key=<MCP_API_KEY> 쿼리 매개변수

Railway에 배포

포함된 Dockerfile은 Railway 배포 준비가 완료된 상태입니다. Railway 프로젝트에서 다음 환경 변수를 설정하세요:

대본 작동 방식

1. 먼저 Pocket Casts에서 생성된 대본을 확인합니다.

2. 없을 경우 RSS 소스 대본을 확인합니다.

3. 둘 다 존재하지 않고 ASSEMBLYAI_API_KEY가 설정되어 있으면, 오디오 URL을 AssemblyAI로 직접 전송하여 대본을 생성합니다 (파일 다운로드 불필요).