MCP Audio

🚀 MCP-Audio插件

mcp-audio 是一款符合AIO - 2030標準的MCP插件，它藉助Audio語音識別API實現語音轉文本的轉錄功能。

該插件通過 multipart/form-data 和 base64 兩種格式對外暴露 identify_voice 方法，支持AIO tools.call 協議，並返回JSON - RPC結構的輸出結果。

🚀 快速開始

本地環境搭建

1. 克隆倉庫並安裝依賴

git clone git@github.com:AIO-2030/mcp-audio.git
cd mcp-audio
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

2. 添加.env文件

cp .env.example .env

設置音頻URL和API密鑰：

AUDIO_URL=https--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. 運行MCP服務器

python src/mcp_server.py

4. 使用Docker

4.1 構建並運行容器

docker build -t mcp-audio .
docker run --env-file .env -p 8080:8080 mcp-audio

✨ 主要特性

• 完全符合AIO標準的MCP插件（支持 /tools.call 和 /help 接口）
• 利用SiliconFlow將 .wav 或 .mp3 音頻文件轉換為文本轉錄
• 通過 .env 文件安全管理API密鑰
• 支持Docker，依賴極少
• 可隨時註冊到AIO端點註冊表

📚 詳細文檔

API概述

POST /api/v1/mcp/voice_model

直接上傳音頻文件，響應如下：

{
  "transcript": "hello world",
  "confidence": 0.91,
  "audio_hash": "a1b2c3..."
}

POST /api/v1/mcp/tools.call (AIO協議)

使用base64編碼音頻的JSON - RPC格式，響應如下：

{
  "method": "tools.call",
  "params": {
    "method": "identify_voice",
    "inputs": [
      {
        "type": "audio",
        "value": "<base64-audio>"
      }
    ]
  }
}

GET /api/v1/mcp/help

自動提供 mcp_audio_registration.json 的內容，供Queen AI用於MCP發現和服務索引。

測試工具

Base64語音測試

python test/test_audio_base64.py

健康檢查

python health_check.py

MCP註冊（到AIO端點容器）

./register_mcp.sh

此操作需要安裝 jq、dfx 以及一個正在運行的端點註冊表容器。