Pipecat MCP 서버는 Pipecat을 사용해 AI 에이전트에게 음성 권한을 부여합니다. 모든 MCP 호환 클라이언트에서 작동할 것입니다:

Pipecat MCP 서버는 음성 관련 및 화면 캡처 도구를 MCP 호환 클라이언트에 노출하지만, 마이크나 스피커 접근은 제공하지 않습니다.

오디오 입출력은 별도의 오디오/비디오 전송에 의해 처리됩니다. 예를 들어:

• Pipecat Playground (로컬 브라우저 UI)
• 데일리 (WebRTC 룸)
• 전화 제공업체 (Twilio, Telnyx 등)

Cursor, Claude Code, Codex 같은 MCP 클라이언트가 에이전트를 제어하지만, 이들은 오디오 장치가 아닙니다. 듣거나 말하거나 보기 위해서는 오디오 전송 중 하나를 통해 연결해야 합니다.

🧭 시작

전제 조건

• Python 3.10 또는 이후
• UV 패키지 관리자

기본적으로 음성 에이전트는 로컬 모델을 사용합니다(API 키가 필요 없음): 음성 변환용 Faster Whisper, 텍스트 음성 변환용 Kokoro. Whisper 모델은 약 1.5GB 용량이며 첫 연결 시 자동으로 다운로드되므로 초기 시작 시간이 조금 걸릴 수 있습니다.

설치

이 과정에서 pipecat-mcp-server 도구가 설치됩니다.

Pipecat MCP Server

Pipecat MCP Server gives your AI agents a voice using Pipecat. It should work with any MCP-compatible client:

The Pipecat MCP Server exposes voice-related and screen capture tools to MCP-compatible clients, but it does not itself provide microphone or speaker access.

Audio input/output is handled by a separate audio/video transport, such as:

• Pipecat Playground (local browser UI)
• Daily (WebRTC room)
• Phone providers (Twilio, Telnyx, etc.)

MCP clients like Cursor, Claude Code, and Codex control the agent, but they are not audio devices. To hear, speak or see, you must connect via one of the audio transports.

🧭 Getting started

Prerequisites

• Python 3.10 or later
• uv package manager

By default, the voice agent uses local models (no API keys required): Faster Whisper for speech-to-text and Kokoro for text-to-speech. The Whisper models are approximately 1.5 GB and are downloaded automatically on the first connection, so the initial startup may take a moment.

Installation

uv tool install pipecat-ai-mcp-server

This will install the pipecat-mcp-server tool.

If you want to use different services or modify the Pipecat pipeline somehow, you will need to clone the repository:

git clone https://github.com/pipecat-ai/pipecat-mcp-server.git

and install your local version with:

uv tool install -e /path/to/repo/pipecat-mcp-server

Running the server

Start the server:

pipecat-mcp-server

This will make the Pipecat MCP Server available at http://localhost:9090/mcp.

Auto-approving permissions

For hands-free voice conversations, you will need to auto-approve tool permissions. Otherwise, your agent will prompt for confirmation, which interrupts the conversation flow.

⚠️ Warning: Enabling broad permissions is at your own risk.

Installing the talk skill (recommended)

The talk skill provides a better voice conversation experience. It asks for verbal confirmation before making changes to files, adding a layer of safety when using broad permissions.