Pipecat MCP 服务器通过 Pipecat 为您的 AI 代理提供语音。它应适用于任何兼容 MCP 的客户端：

Pipecat MCP 服务器向兼容 MCP 的客户端开放与语音相关和屏幕捕获工具，但它本身不提供麦克风或扬声器访问。

音频输入/输出由独立的音频/视频传输处理，例如：

• Pipecat Playground（本地浏览器界面）
• 每日新闻（WebRTC房间）
• 电话服务提供商（Twilio、Telnyx等）

MCP 客户端如 Cursor、Claude Code 和 Codex 控制代理，但它们不是音频设备。 要听、说或看，必须通过音频传输连接。

🧭 开始

先决条件

• Python 3.10 或更高版本
• UV包管理器

默认情况下，语音代理使用本地模型（无需 API 密钥）：语音转文字时使用 Faster Whisper，文字转语音时使用 Kokoro。Whisper 型号约为 1.5 GB，首次连接时自动下载，初始启动可能需要一些时间。

安装

这将安装 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.