Resemble

🚀 使用Resemble AI的語音生成服務器

使用Resemble AI的語音生成服務器，您可以通過多種方式將其集成到項目中，例如與Cursor AI和Claude Desktop進行集成。本README將為您詳細介紹服務器的設置、運行以及集成的具體步驟。

🚀 快速開始

使用Resemble AI的語音生成服務器，您能夠藉助多種方式將其與項目相連接，涵蓋與Cursor AI和Claude Desktop的集成。接下來，我們將逐步引導您完成設置、運行及集成的整個流程。

📦 安裝指南

創建虛擬環境（推薦）

為保證項目的兼容性，建議為其創建一個獨立的Python環境：

python -m venv mcp-venv
source mcp-venv/bin/activate  # 在Windows上使用 `mcp-venv\Scripts\activate`

安裝依賴項

在激活的環境中安裝所需的包：

pip install uvicorn fastapi python-dotenv requests pydantic httpx sse-starlette
pip install git+https://github.com/modelcontextprotocol/python-sdk.git

🔧 配置環境變量

複製並編輯示例環境文件：

cp .env.example .env

在.env文件中添加您的Resemble AI API密鑰：

RESEMBLE_API_KEY=your_api_key_here

可選操作：自定義音頻輸出設置：

OUTPUT_DIR=./output
AUDIO_FORMAT=mp3

創建輸出目錄：

mkdir -p output

💻 運行服務器

使用新的CLI工具來運行服務器，它支持多種實現方式：

# 激活您的環境（如果尚未激活）
conda activate resemble-mcp
# 或者
source venv/bin/activate

# 使用MCP SDK實現（推薦）
python -m src.cli --implementation mcp --port 8083

# 其他實現：
# HTTP API實現
python -m src.cli --implementation http --port 8083
# 直接API實現
python -m src.cli --implementation direct --port 8083
# Resemble SDK實現
python -m src.cli --implementation sdk --port 8083

📚 集成指南

集成到Cursor AI

在Cursor中，可通過SSE接口與Resemble AI語音生成服務器進行交互：

1. 打開Cursor的設置 -> AI -> MCP服務器。
2. 點擊“添加服務器”並輸入SSE URL：http://localhost:8083/sse（根據需要調整端口）。

集成到Claude Desktop

在Claude Desktop中配置MCP服務器： 編輯claudia.json文件，添加以下內容：

{
  "mcpServers": {
    "resemble-ai": {
      "command": "python",
      "args": ["-m", "src.cli", "--implementation", "mcp"],
      "env": {
        "RESEMBLE_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

📄 工具文檔

list_voices

列出Resemble AI的所有可用語音模型。

• 參數：無
• 返回：
  • voices：包含語音模型ID、名稱、性別、語言、口音和描述的列表。

generate_tts

從文本生成語音。

• 參數：
  • text：要轉換為語音的文本。
  • voice_id：目標語音模型的ID（在list_voices中獲取）。
  • output_path：保存生成音頻文件的路徑。
• 返回：音頻文件保存到指定路徑。

💻 使用示例

生成語音

python -m src.cli generate-tts "This is a test." --voice_id your_voice_id --output_path output/audio.mp3

列出語音

python -m src.cli list-voices

⚠️ 注意事項

⚠️ 重要提示

1. Python版本要求：MCP包需要使用Python 3.10或更高版本。
2. API密鑰安全：確保您的Resemble API密鑰安全，避免洩露。
3. 端口衝突：如果8083端口被佔用，請嘗試其他端口。

📚 常見問題

問題1：如何獲取語音ID？

使用list_voices命令獲取可用的語音模型列表：

python -m src.cli list-voices

問題2：如何處理音頻格式？

在.env文件中設置輸出格式（如mp3或wav）。

🌟 結語

通過本README文檔，您可以輕鬆地將Resemble AI的語音生成服務器集成到項目中，並與Cursor AI和Claude Desktop實現無縫協作。