MCP AI Voice

🎵 MCP Nexus语音v1.2.0

混合语音架构：平台+OpenAI TTS

通过智能引擎选择，使AI代理能够通过自然的语音合成来表达自己。支持零配置平台语音和高级OpenAI TTS，并具有自动回退功能。

✨ 特性

🌩️ 混合式结构

• 平台TTS：零配置系统声音（macOS、Windows、Linux）
• OpenAI TTS：当提供API密钥时，高级基于云的合成
• 智能选择：具有优雅回退功能的自动发动机选择
• 异步处理：无阻塞语音合成

🎭 语音选项

• 平台声音：34多种语言，质量优化
• OpenAI语音：6种高级音色（合金、回声、寓言、缟玛瑙、新星、微光）
• 质量模式：标准（tts-1）和高清（tts-1-HD）
• 速度控制：0.25倍至4.0倍的播放速度

🔄 智能回退

• OpenAI→ 平台错误回退
• 优雅的降级，不会中断工作流程
• 全面的错误处理和记录
• 背景播放：无需打开窗口或应用程序即可直接播放音频

🚀 快速开始

安装

npm install -g @sylweriusz/mcp-ai-voice

环境配置（.env）

为了便于配置，请复制示例环境文件：

cp .env.example .env

编辑 .env 使用您的设置：

# Required for OpenAI TTS
OPENAI_API_KEY=sk-your-actual-api-key-here

# Optional customizations
DEFAULT_TTS_VOICE=nova          # Your preferred OpenAI voice
DEFAULT_TTS_MODEL=tts-1-hd      # Higher quality model
DEFAULT_TTS_SPEED=1.2           # Slightly faster speech

Claude桌面配置

基本设置（仅限平台TTS）

{
  "mcpServers": {
    "ai-voice": {
      "command": "npx",
      "args": ["@sylweriusz/mcp-ai-voice"]
    }
  }
}

混合设置（平台+OpenAI TTS）

选项1：环境变量

{
  "mcpServers": {
    "ai-voice": {
      "command": "npx",
      "args": ["@sylweriusz/mcp-ai-voice"],
      "env": {
        "OPENAI_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

选项2：使用.env文件（推荐）

{
  "mcpServers": {
    "ai-voice": {
      "command": "npx",
      "args": ["@sylweriusz/mcp-ai-voice"]
    }
  }
}

*注意：确保 .env 文件位于项目目录中 OPENAI_API_KEY 已配置。*

🎮 使用示例

基本语音表达

// Simple usage - auto-selects best engine
say("Hello! I'm excited to help you today!")

// Platform-specific language
say("Witam! Jak się masz?", { language: "pl" })

// macOS Easter Egg - exact voice names
say("Welcome to the future!", { language: "Fred" })

OpenAI TTS使用

// Use OpenAI with default settings
say("This uses premium OpenAI synthesis!", { useOpenAI: true })

// Specific OpenAI voice and model
say("Deep, authoritative voice", {
  useOpenAI: true,
  openaiVoice: "onyx",
  openaiModel: "tts-1-hd"
})

// Speed control
say("Speaking at double speed!", {
  useOpenAI: true,
  openaiSpeed: 2.0
})

// Warm female voice with HD quality
say("Natural, engaging conversation", {
  useOpenAI: true,
  openaiVoice: "nova",
  openaiModel: "tts-1-hd"
})

发动机选择策略

// Force platform engine (even if OpenAI available)
say("Using system voice", { useOpenAI: false })

// Auto-selection (prefers OpenAI if available)
say("Best available quality")

// Fallback demonstration
say("This will use OpenAI, but fall back to platform on error", {
  useOpenAI: true
})

🎭 语音特征

OpenAI语音

• 合金：平衡、多变的声音
• 回声：清晰、直接的男性声音⭐ （默认）
• 寓言：富有表现力、讲故事的声音
• 缟玛瑙：深沉、权威的男性嗓音
• 新星：温暖、迷人的女性嗓音
• 闪烁：明亮、充满活力的女性嗓音

平台声音

• macOS：具有传统选项的高级系统声音
• 视窗：具有质量检测功能的SAPI语音
• Linux：具有语言优化功能的espeak语音

⚙️ 配置

环境变量

# Required for OpenAI TTS
OPENAI_API_KEY=sk-your-api-key-here

# Optional: Default voice preference (OpenAI)
DEFAULT_TTS_VOICE=echo

# Optional: Audio player command override
AUDIO_PLAYER_COMMAND=vlc

刀具参数

{
  text: "Required text to synthesize",
  
  // Platform engine options
  language: "pl",           // Language code or macOS voice name
  
  // OpenAI engine options
  useOpenAI: true,          // Force OpenAI engine
  openaiVoice: "nova",      // OpenAI voice selection
  openaiModel: "tts-1-hd",  // Quality: tts-1 or tts-1-hd
  openaiSpeed: 1.5          // Speed: 0.25 to 4.0
}

🏗️ 建筑

混合动力发动机选择

1. API密钥检查：OpenAI可用，如果 OPENAI_API_KEY 提供
2. 用户首选项: useOpenAI 参数覆盖自动选择
3. 自动选择：如果可用，更喜欢OpenAI
4. 后备方案：OpenAI错误触发平台引擎回退
5. 平台备份：始终可用作可靠性基线

性能优化

• 异步处理：非阻断合成
• 背景音频：无需打开窗口或应用程序即可直接播放音频
• 清理管理：自动临时文件清理
• 差错恢复：API问题的优雅降级

🛠️ 发展

从源代码构建

git clone https://github.com/sylweriusz/mcp-ai-voice.git
cd mcp-ai-voice
npm install
npm run build
npm start

测试混合动力设置

# Test platform engine only
node dist/index.js

# Test with OpenAI (requires API key)
OPENAI_API_KEY=sk-... node dist/index.js

📊 监控

该系统提供全面的日志记录：

🎵 AI Voice v1.2.0 - Hybrid Voice Architecture
🔍 Initializing voice ecosystem...
📊 Engine Status:
   🎯 Platform TTS: Available
   🌩️ OpenAI TTS: Available
   ⭐ Preferred: OPENAI
📡 Hybrid voice synthesis ready
🎯 Platform: darwin

🤝 贡献

1. 分叉存储库
2. 创建要素分支： git checkout -b feature-name
3. 测试两台发动机的混合动力功能
4. 提交带有测试用例的pull请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🔗 链接

• 仓库: https://github.com/sylweriusz/mcp-ai-voice
• NPM包: https://www.npmjs.com/package/@sylweriusz/mcp人工智能语音
• 问题: https://github.com/sylweriusz/mcp-ai-voice/issues
• OpenAI TTS文档: https://platform.openai.com/docs/api-reference/audio/createSpeech

______________________________________________________________________

🎵 用声音表达自己——混合方式！