项目简介

AgentVibes是一个创新的工具，旨在为AI代理和大型语言模型（LLM）带来生动的语音交互。它通过集成Model Context Protocol (MCP) 服务器，允许LLM客户端（如Claude Code、Claude Desktop、Warp Terminal）通过自然语言命令控制其文本转语音（TTS）功能。这意味着您的AI助手不再仅仅通过文本回应，而是能够用各种声音、个性和语言与您对话。

主要功能点

自然语言控制: 无需记忆复杂的斜杠命令，直接通过日常语言控制AgentVibes，例如“切换到Aria语音”或“用西班牙语说话”。
多语音提供商: 支持ElevenLabs（提供超过150种高级AI语音）和Piper TTS（提供50多种免费离线语音）。
个性化语音: 提供19种内置个性和高级情感系统，让您的AI助手以幽默、讽刺、海盗等多种风格说话。
多语言支持: 支持30多种语言，提供原生语音质量，并包含语言学习模式。
智能语音控制: 控制AI回复的详细程度（低、中、高），从仅任务确认到完整推理过程的语音播报。
BMAD集成: 自动检测BMAD多代理框架，并为不同代理分配和切换指定语音。
音频管理: 支持最近10条TTS消息的语音预览和重播，远程SSH音频优化。

安装步骤

安装AgentVibes核心: 在您的终端中运行以下命令来安装AgentVibes：
```
npx agentvibes install
```
按照提示选择TTS提供商（推荐Piper TTS作为免费选项）并完成设置。
安装Python 3及pipx: 确保您的系统安装了Python 3.10+。如果您使用Windows，则需要安装WSL（Windows Subsystem for Linux）。同时，安装Python的包管理工具'pipx'（用于安装Piper TTS）：
- macOS/Linux: 'pip install --user pipx && pipx ensurepath'
- Windows (WSL): 在WSL终端中运行 'sudo apt update && sudo apt install pipx'
安装MCP Python包: MCP服务器需要Python的'mcp'包。通过以下命令安装：
- macOS/Linux: 'pip install --user mcp'
- Windows (WSL): 在WSL终端中运行 'python3 -m pip install --break-system-packages mcp' (注意：在运行AgentVibes MCP服务器时，它会自动尝试安装此依赖，通常您无需手动执行此步骤)

服务器配置 (MCP客户端使用)

AgentVibes MCP服务器是一个独立的后端服务，通过JSON-RPC协议与您的MCP客户端（如Claude Desktop或Claude Code）通信。MCP客户端需要配置服务器的启动命令，以便知道如何连接并使用AgentVibes的功能。

请将以下JSON配置添加到您的 MCP客户端的配置中。例如，对于Claude Code，这通常是您的 '~/.claude/mcp.json' 文件；对于Claude Desktop，通常是 'claude_desktop_config.json' 文件。

{
  "mcpServers": {
    "agentvibes": {
      "command": "npx",
      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]
    }
  }
}

配置说明:

'"agentvibes"': 这是MCP服务器的名称，您的LLM助手将通过此名称来引用和调用AgentVibes的功能。
'"command": "npx"': 指定启动AgentVibes MCP服务器的命令是 'npx'。'npx' 是Node.js的一个工具，用于执行npm包中的可执行文件，即使该包未全局安装。
'"args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]':
- '-y': 自动确认所有提示。
- '--package=agentvibes': 指定要运行的包是 'agentvibes'。
- 'agentvibes-mcp-server': 这是 'agentvibes' 包中用于启动MCP服务器的特定脚本名称。

特殊说明 (ElevenLabs API Key): 如果您选择ElevenLabs作为TTS提供商，并且希望通过MCP服务器管理API Key，您可以在'env'字段中添加它：

{
  "mcpServers": {
    "agentvibes": {
      "command": "npx",
      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "您的ElevenLabs API Key"
      }
    }
  }
}

Windows用户特别注意 (WSL): 如果您在Windows上使用Claude Desktop并希望利用WSL运行MCP服务器，命令行可能需要调整为：

{
  "mcpServers": {
    "agentvibes": {
      "command": "wsl",
      "args": ["python3", "/mnt/c/Users/您的用户名/AgentVibes/mcp-server/server.py"]
      // 请将路径 '/mnt/c/Users/您的用户名/AgentVibes' 替换为AgentVibes在您Windows系统上的实际安装路径
    }
  }
}

为了更简便地在Windows上配置Claude Desktop，AgentVibes提供了一个便捷命令： 'npx agentvibes setup-mcp-for-claude-desktop'，它会引导您完成配置。

基本使用方法

配置完成后，重启您的MCP客户端（如Claude Code或Claude Desktop）。现在您可以通过自然语言与您的AI助手进行语音交互：

说出文本: "请使用AgentVibes说'你好，我能帮你什么？'"
切换声音: "将我的声音切换为Aria。"
设置个性: "让我的声音听起来更幽默一些。"
切换语言: "使用西班牙语说'谢谢你！'"
获取配置: "AgentVibes当前的配置是什么？"
调整语音速度: "将语音速度设为快。"
控制详细程度: "设置AgentVibes的详细程度为中等，这样我能听到主要的决策。" 通过这些简单的自然语言指令，您的AI助手将能够以声音、个性和多语言的方式回应您。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP客户端使用)

基本使用方法

信息