MCP Elevenlab Scribe ASR

🚀 ElevenLabsscribe MCP 服務器

ElevenLabsscribe MCP 服務器是針對 ElevenLabs' Scribe 語音轉文字 API 的 Model Control Protocol (MCP) 服務器實現，具備即時轉錄功能，支持高級上下文管理及雙向流技術，能有效提升語音轉錄的效率與準確性。

🚀 快速開始

本服務器可提供即時轉錄等功能，以下是啟動服務器及使用客戶端進行轉錄的步驟。

啟動服務器

python -m elevenlabs_scribe_mcp_server.main

服務器將啟動在默認端口 8000 或下一個可用端口。

示例客戶端使用

1. 文件轉錄：

python examples/client_example.py --file path/to/audio.wav

2. 麥克風轉錄：

python examples/client_example.py --mic

✨ 主要特性

• 即時轉錄：直接從麥克風流式傳輸音頻，獲取即時轉錄結果。
• 文件批量處理：上傳音頻文件進行批次處理。
• MCP 協議支持：完整實現模型控制協議，提升上下文管理能力。
• WebSocket 支持：即時雙向通信功能。
• 上下文管理：維護對話上下文以提高轉錄準確性。
• 多種音頻格式：支持多種音頻格式並自動轉換。
• 語言檢測：自動識別語言及置信度評分。
• 事件檢測：識別語音與非語音音頻片段。

📦 安裝指南

以下是安裝本項目的詳細步驟：

1. 克隆倉庫：

git clone https://github.com/aromanstatue/MCP-Elevenlab-Scribe-ASR.git
cd MCP-Elevenlab-Scribe-ASR

2. 創建並激活虛擬環境：

python -m venv venv
source venv/bin/activate  # 在 Windows 系統中使用：venv\Scripts\activate

3. 安裝依賴項：

pip install -e .

4. 創建包含 API 密鑰的 .env 文件：

ELEVENLABS_API_KEY=your-api-key-here

💻 使用示例

基礎用法

上述的啟動服務器和示例客戶端使用步驟就是基礎的使用方式，可快速實現文件或麥克風的轉錄。

高級用法

API 接口調用

本項目提供了 REST API 和 WebSocket API 兩種接口，可根據不同需求進行調用。

1. REST API：
   • POST /transcribe：上傳音頻文件進行轉錄。
   • GET /health：健康檢查接口。
2. WebSocket API：
   • ws://localhost:8000/ws/transcribe：即時音頻轉錄。

MCP 協議使用

服務器實現了模型控制協議（MCP），支持以下消息類型：

1. INIT：初始化新的轉錄會話。
2. START：開始音頻流式傳輸。
3. AUDIO：發送音頻數據。
4. TRANSCRIPTION：接收轉錄結果。
5. ERROR：錯誤信息。
6. STOP：結束音頻流式傳輸。
7. DONE：完成會話。

📚 詳細文檔

開發指南

運行測試

pytest tests/

項目結構

elevenlabs-scribe-mcp-server/
├── elevenlabs_scribe_mcp_server/
│   ├── __init__.py
│   ├── main.py              # FastAPI 服務器入口
│   └── mcp/
│       ├── __init__.py
│       ├── protocol.py      # MCP 協議處理模塊
│       ├── types.py         # 協議類型定義
│       └── elevenlabs.py    # ElevenLabs 實現模塊
├── examples/
│   └── client_example.py    # 示例客戶端代碼
├── tests/
│   └── test_transcribe.py   # 測試套件
├── pyproject.toml           # 項目元數據文件
└── README.md                # 項目說明文檔

依賴項

• Python 3.8+
• FastAPI
• Uvicorn
• PyAudio（麥克風支持）
• aiohttp
• python-dotenv
• pydantic

貢獻指南

1. 叉克倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交修改（git commit -m 'Add amazing feature'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 提交 Pull Request。

📄 許可證

本項目採用 MIT License。

如需瞭解詳細信息，請參考 官方文檔。