오디오 MCP 서버

클로드와 같은 AI 비서에게 오디오 입출력 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 클로드는 마이크 녹음 및 스피커 재생 등 컴퓨터 오디오 시스템과 상호 작용할 수 있습니다.

특징

• 오디오 장치 나열 : 시스템에서 사용 가능한 모든 마이크와 스피커를 확인합니다.
• 오디오 녹음 : 사용자 지정 가능한 지속 시간과 품질로 모든 마이크에서 오디오를 캡처합니다.
• 녹음 재생 : 가장 최근 녹음을 재생합니다.
• 오디오 파일 재생 : 스피커를 통해 오디오 파일을 재생합니다.
• 텍스트 음성 변환 : (향후 구현을 위한 자리 표시자)

요구 사항

• Python 3.8 이상
• 시스템의 오디오 입력/출력 장치

설치

1. 이 저장소를 복제하거나 컴퓨터에 파일을 다운로드하세요.

지엑스피1

2. 가상 환경을 만들고 종속성을 설치합니다.

3. 또는 포함된 설치 스크립트를 사용하여 설치를 자동화하세요.

구성

클로드 데스크톱 구성

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

감사의 말

• 모델 컨텍스트 프로토콜을 사용하여 구축됨
• 오디오 처리를 위해 사운드 장치 와 사운드 파일을 사용합니다.

참고: 이 서버는 마이크와 스피커에 접근할 수 있는 도구를 제공합니다. 도구 작업을 실행하기 전에 항상 검토하고 승인하세요.