remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Enables Windsurf, a Codeium product, to leverage ElevenLabs' audio processing and text-to-speech capabilities.
Enables interaction with ElevenLabs Text to Speech and audio processing APIs, allowing for speech generation, voice cloning, audio transcription, voice design, and audio isolation capabilities.
Allows OpenAI Agents to use ElevenLabs' text-to-speech and audio processing features to generate and manipulate audio content.
Claude Desktop으로 빠른 시작
- ElevenLabs 에서 API 키를 받으세요. 월 1만 크레딧을 제공하는 무료 티어가 있습니다.
uv(Python 패키지 관리자)를 설치하고curl -LsSf https://astral.sh/uv/install.sh | sh로 설치하거나, 추가 설치 방법은uv저장소를 참조하세요.- Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json으로 이동하여 다음을 포함합니다.
지엑스피1
Windows를 사용하는 경우, MCP 서버를 사용하려면 Claude Desktop에서 "개발자 모드"를 활성화해야 합니다. 왼쪽 상단의 햄버거 메뉴에서 "도움말"을 클릭하고 "개발자 모드 활성화"를 선택하세요.
다른 MCP 클라이언트
Cursor 및 Windsurf와 같은 다른 클라이언트의 경우 다음을 실행하세요.
pip install elevenlabs-mcppython -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print사용하여 구성을 가져옵니다. MCP 클라이언트에서 지정한 적절한 구성 디렉터리에 붙여넣으세요.
이제 MCP 클라이언트는 다음 도구를 통해 ElevenLabs와 상호 작용할 수 있습니다.
사용 예
⚠️ 경고: 이 도구를 사용하려면 ElevenLabs 크레딧이 필요합니다.
클로드에게 물어보세요:
- "영화 누아르 탐정처럼 말하고 고전 영화에 대한 질문에 답할 수 있는 AI 에이전트를 만들어 보세요."
- "현명한 고대 용 캐릭터에 대한 세 가지 음성 변형을 생성한 다음, 내 음성 라이브러리에 추가할 가장 마음에 드는 음성을 선택하겠습니다."
- "내 목소리를 중세 기사처럼 들리도록 변환해줘"
- "울창한 정글 속 폭풍우 소리와 날씨에 반응하는 동물들의 사운드스케이프를 만들어 보세요."
- "이 연설을 텍스트로 바꾸고, 다른 화자를 식별한 다음, 각 사람의 고유한 음성을 사용하여 다시 변환하세요."
선택 사양
claude_desktop_config.json 에 ELEVENLABS_MCP_BASE_PATH 환경 변수를 추가하여 MCP 서버가 찾아야 하는 기본 경로를 지정하고 상대 경로로 지정된 파일을 출력할 수 있습니다.
기여하다
소스에서 기여하거나 실행하려면:
- 저장소를 복제합니다.
- uv를 사용하여 가상 환경을 만들고 종속성을 설치합니다.
.env.example``.env로 복사하고 ElevenLabs API 키를 추가하세요.
- 모든 것이 제대로 작동하는지 확인하기 위해 테스트를 실행하세요.
- Claude Desktop에 서버를 설치하세요:
mcp install elevenlabs_mcp/server.py - MCP Inspector를 사용하여 로컬에서 디버깅하고 테스트하세요:
mcp dev elevenlabs_mcp/server.py
문제 해결
Claude Desktop을 실행할 때의 로그는 다음 위치에서 확인할 수 있습니다.
- Windows :
%APPDATA%\Claude\logs\mcp-server-elevenlabs.log - macOS :
~/Library/Logs/Claude/mcp-server-elevenlabs.log
특정 도구 사용 시 시간 초과 발생
음성 디자인 및 오디오 분리와 같은 일부 ElevenLabs API 작업은 해결하는 데 시간이 오래 걸릴 수 있습니다. 개발자 모드에서 MCP 검사기를 사용할 경우 도구가 의도한 작업을 완료했음에도 불구하고 시간 초과 오류가 발생할 수 있습니다.
Claude와 같은 클라이언트를 사용하는 경우 이런 일이 발생하지 않아야 합니다.
MCP ElevenLabs: uvx ENOENT 생성
"MCP ElevenLabs: spawn uvx ENOENT" 오류가 발생하면 터미널에서 다음 명령을 실행하여 절대 경로를 확인하세요.
절대 경로(예: /usr/local/bin/uvx )를 얻은 후 해당 경로를 사용하도록 구성을 업데이트하세요(예: "command": "/usr/local/bin/uvx" ). 이렇게 하면 올바른 실행 파일이 참조됩니다.
You must be authenticated.
AI 클라이언트가 ElevenLabs의 텍스트 음성 변환 및 오디오 처리 API와 상호 작용하여 음성 생성, 음성 복제, 오디오 필사 및 기타 오디오 관련 작업을 수행할 수 있도록 하는 공식 모델 컨텍스트 프로토콜(MCP) 서버입니다.