Аудио MCP-сервер

Сервер MCP (Model Context Protocol), который обеспечивает возможности аудиоввода/вывода для помощников ИИ, таких как Клод. Этот сервер позволяет Клоду взаимодействовать с аудиосистемой вашего компьютера, включая запись с микрофонов и воспроизведение звука через динамики.

Функции

• Список аудиоустройств : просмотр всех доступных микрофонов и динамиков в вашей системе.

• Запись звука : записывайте звук с любого микрофона с настраиваемой длительностью и качеством.

• Воспроизведение записей : воспроизведите последнюю запись.

• Воспроизведение аудиофайлов : воспроизведение аудиофайлов через динамики.

• Преобразование текста в речь : (заполнитель для будущей реализации)

Related MCP server: Sound Effects MCP

Требования

• Python 3.8 или выше

• Устройства ввода/вывода звука в вашей системе

Установка

Установка через Smithery

Чтобы автоматически установить сервер аудиоинтерфейса для Claude Desktop через Smithery :

npx -y @smithery/cli install @GongRzhe/Audio-MCP-Server --client claude

Ручная установка

1. Клонируйте этот репозиторий или загрузите файлы на свой компьютер:

git clone https://github.com/GongRzhe/Audio-MCP-Server.git
cd Audio-MCP-Server

2. Создайте виртуальную среду и установите зависимости:

# Windows
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

# macOS/Linux
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Или используйте прилагаемый скрипт установки для автоматизации установки:

python setup_mcp.py

Конфигурация

Конфигурация рабочего стола Клода

Чтобы использовать этот сервер с Claude Desktop, добавьте следующее в файл конфигурации Claude Desktop:

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "audio-interface": {
      "command": "/path/to/your/.venv/bin/python",
      "args": [
        "/path/to/your/audio_server.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/audio-mcp-server"
      }
    }
  }
}

Замените пути на фактические пути в вашей системе. Скрипт установки сгенерирует эту конфигурацию для вас.

Использование

После настройки сервера перезапустите Claude Desktop. В поле ввода должен появиться значок молотка, указывающий на то, что инструменты доступны.

Попробуйте спросить Клода:

• «Какие микрофоны и динамики доступны в моей системе?»

• «Запишите 5 секунд звука с моего микрофона».

• «Воспроизвести аудиозапись».

• «Воспроизвести аудиофайл с моего компьютера».

Доступные инструменты

список_аудио_устройств

Перечисляет все доступные устройства ввода и вывода звука в вашей системе.

запись_аудио

Записывает звук с вашего микрофона.

Параметры:

• duration : Длительность записи в секундах (по умолчанию: 5)

• sample_rate : Частота дискретизации в Гц (по умолчанию: 44100)

• channels : количество аудиоканалов (по умолчанию: 1)

• device_index : Конкретный индекс устройства ввода для использования (по умолчанию: системное значение по умолчанию)

воспроизведение_последней_записи

Воспроизводит последний записанный звук.

воспроизведение_аудио

Заполнитель для функции преобразования текста в речь.

Параметры:

• text : Текст для преобразования в речь.

• voice : используемый голос (по умолчанию: «default»)

воспроизведение_аудио_файла

Воспроизводит аудиофайл через динамики.

Параметры:

• file_path : Путь к аудиофайлу

• device_index : Конкретный индекс устройства вывода для использования (по умолчанию: системное значение по умолчанию)

Поиск неисправностей

Устройства не найдены.

Если аудиоустройства не обнаружены, проверьте:

• Ваш микрофон и динамики подключены правильно

• Ваша операционная система распознает устройства

• У вас есть необходимые разрешения для доступа к аудиоустройствам

Проблемы с воспроизведением

Если воспроизведение звука не работает:

• Проверьте настройки громкости.

• Убедитесь, что выбрано правильное выходное устройство.

• Попробуйте перезапустить приложение Claude Desktop.

Подключение к серверу

Если Клод не может подключиться к серверу:

• Проверьте правильность путей конфигурации.

• Убедитесь, что Python и все зависимости установлены.

• Проверьте журналы Клода на наличие сообщений об ошибках.

Лицензия

Массачусетский технологический институт

Благодарности

• Создано с использованием протокола контекста модели

• Использует звуковое устройство и звуковой файл для обработки звука

Примечание: Этот сервер предоставляет инструменты, которые могут получить доступ к вашему микрофону и динамикам. Всегда проверяйте и одобряйте действия инструментов перед их выполнением.