오디오 MCP 서버
클로드와 같은 AI 비서에게 오디오 입출력 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 클로드는 마이크 녹음 및 스피커 재생 등 컴퓨터 오디오 시스템과 상호 작용할 수 있습니다.
특징
오디오 장치 나열 : 시스템에서 사용 가능한 모든 마이크와 스피커를 확인합니다.
오디오 녹음 : 사용자 지정 가능한 지속 시간과 품질로 모든 마이크에서 오디오를 캡처합니다.
녹음 재생 : 가장 최근 녹음을 재생합니다.
오디오 파일 재생 : 스피커를 통해 오디오 파일을 재생합니다.
텍스트 음성 변환 : (향후 구현을 위한 자리 표시자)
Related MCP server: Audio Player MCP Server
요구 사항
Python 3.8 이상
시스템의 오디오 입력/출력 장치
설치
이 저장소를 복제하거나 컴퓨터에 파일을 다운로드하세요.
지엑스피1
가상 환경을 만들고 종속성을 설치합니다.
또는 포함된 설치 스크립트를 사용하여 설치를 자동화하세요.
구성
클로드 데스크톱 구성
Claude Desktop과 함께 이 서버를 사용하려면 Claude Desktop 구성 파일에 다음을 추가하세요.
macOS :
~/Library/Application Support/Claude/claude_desktop_config.json윈도우 :
%APPDATA%\Claude\claude_desktop_config.json
경로를 시스템의 실제 경로로 바꾸세요. 설치 스크립트가 이 구성을 자동으로 생성합니다.
용법
서버를 설정한 후 Claude Desktop을 다시 시작하세요. 입력란에 망치 아이콘이 표시되면 도구를 사용할 수 있음을 나타냅니다.
클로드에게 물어보세요:
"내 시스템에는 어떤 마이크와 스피커가 있나요?"
"마이크에서 5초 분량의 오디오를 녹음합니다."
"오디오 녹음을 재생하세요."
"내 컴퓨터에서 오디오 파일을 재생합니다."
사용 가능한 도구
오디오 장치 목록
시스템에서 사용 가능한 모든 오디오 입력 및 출력 장치를 나열합니다.
녹음_오디오
마이크에서 오디오를 녹음합니다.
매개변수:
duration: 녹음 지속시간(초) (기본값: 5)sample_rate: 샘플링 속도(Hz) (기본값: 44100)channels: 오디오 채널 수 (기본값: 1)device_index: 사용할 특정 입력 장치 인덱스(기본값: 시스템 기본값)
최신 녹음 재생
가장 최근에 녹음된 오디오를 재생합니다.
오디오 재생
텍스트-음성 변환 기능을 위한 자리 표시자입니다.
매개변수:
text: 음성으로 변환할 텍스트voice: 사용할 음성 (기본값: "default")
오디오 파일 재생
스피커를 통해 오디오 파일을 재생합니다.
매개변수:
file_path: 오디오 파일 경로device_index: 사용할 특정 출력 장치 인덱스(기본값: 시스템 기본값)
문제 해결
장치를 찾을 수 없습니다
오디오 장치가 발견되지 않으면 다음을 확인하세요.
마이크와 스피커가 제대로 연결되어 있습니다.
귀하의 운영 체제가 장치를 인식합니다
오디오 장치에 액세스하는 데 필요한 권한이 있습니다.
재생 문제
오디오 재생이 작동하지 않는 경우:
볼륨 설정을 확인하세요
올바른 출력 장치가 선택되었는지 확인하세요
Claude Desktop 애플리케이션을 다시 시작해 보세요.
서버 연결
Claude가 서버에 연결할 수 없는 경우:
구성 경로가 올바른지 확인하세요
Python과 모든 종속성이 설치되어 있는지 확인하세요.
Claude의 로그에서 오류 메시지를 확인하세요.
특허
MIT
감사의 말
모델 컨텍스트 프로토콜을 사용하여 구축됨
참고: 이 서버는 마이크와 스피커에 접근할 수 있는 도구를 제공합니다. 도구 작업을 실행하기 전에 항상 검토하고 승인하세요.