Aivisspeech

🚀 AivisSpeech MCP 服務器

AivisSpeech MCP 服務器是用於語音合成的 Model Context Protocol (MCP) 服務器的實現。它與 AivisSpeech 引擎協同工作，提供語音合成接口。藉助 MCP 協議，AI 助手等應用程序能夠輕鬆使用 AivisSpeech 的語音合成功能。

🚀 快速開始

AivisSpeech MCP 服務器提供了一系列實用功能，讓你能夠輕鬆實現語音合成。以下是使用該服務器的基本步驟：

必要條件

• Node.js 18.x 以上
• npm 9.x 以上
• AivisSpeech 引擎（需另行安裝）

安裝

# 克隆倉庫
git clone https://github.com/kentaro/aivis-speech-mcp.git
cd aivis-speech-mcp

# 安裝依賴
npm install

# 構建項目
npm run build

# 環境變量設置
cp .env.sample .env
# 編輯 .env 文件，進行必要的配置

# Cursor MCP 設置
cp .cursor/mcp.json.sample .cursor/mcp.json
# 將 mcp.json 文件內的 "/path/to/aivis-speech-mcp/dist/index.js" 
# 替換為實際的項目路徑
# 示例: "C:/Users/username/path/to/aivis-speech-mcp/dist/index.js"

環境配置

在 .env 文件中進行以下配置：

# AivisSpeech API 配置
AIVIS_SPEECH_API_URL=http://localhost:10086  # 示例地址，需根據實際情況修改
AIVIS_SPEECH_API_KEY=your_api_key_here      # 替換為實際的 API 密鑰

# 其他配置（如有）
SAMPLE_TEXT=hello                            # 示例文本

基本使用步驟

1. 安裝依賴：運行 npm install 安裝所需模塊。
2. 環境配置：編輯 .env 文件，填寫正確的 API 地址和密鑰。
3. 構建項目：運行 npm run build 進行構建。
4. 啟動服務：運行 npm start 啟動服務器。

示例命令

# 安裝依賴
npm install

# 構建項目
npm run build

# 啟動服務器
npm start

✨ 主要特性

• 符合 MCP 協議的 API 端點
• 高品質語音合成（通過 AivisSpeech 引擎）
• TypeScript 的類型安全設計
• 簡單的設置和高擴展性架構

📚 詳細文檔

架構

• 前端：負責接收用戶請求和展示結果。
• 後端：處理業務邏輯，與 AivisSpeech 引擎通信。
• 引擎：提供語音合成服務。

API 規格

請求格式

{
  "text": "hello world",
  "speaker_id": "1",
  "format": "wav"
}

響應格式

{
  "audio_url": "http://example.com/audio.wav",
  "duration": 3.5
}

MCP 協議連攜

通過 MCP 協議，實現與 AI 助手的無縫對接。具體步驟如下：

1. 註冊服務：在 MCP 中心註冊語音合成服務。
2. 配置參數：設置相關參數（如音調、速度等）。
3. 處理請求：接收並處理來自 MCP 的合成請求。

故障排除

常見問題及解決方法

• 無法連接到 AivisSpeech 引擎：
  • 檢查 .env 文件中的 AIVIS_SPEECH_API_URL 是否正確。
  • 確保引擎已啟動且網絡暢通。
• 語音未播放：
  • 檢查系統語音設置，確保正確的音頻設備已選擇。
  • 確保生成的音頻文件路徑和權限正確。
• speaker_id 無效：
  • 確認 AivisSpeech 引擎中存在該 speaker_id。
  • 參考引擎文檔獲取可用的 speaker ID 列表。

📄 許可證

MIT

致謝

• AivisSpeech 引擎團隊
• Model Context Protocol 開發者