项目简介

VOICEVOX MCP 通知服务器是一个实用工具，它允许您在LLM客户端（例如Claude Code）中执行任务时，通过语音接收任务的实时状态通知。它利用流行的VOICEVOX语音合成引擎，以“ずんだもん”的可爱声音播报任务的开始、进行中、完成或错误信息。

主要功能点

实时语音通知: 自动将LLM客户端中的任务状态（开始、进行中、完成、错误）转换为语音进行播报。
简洁明了: 语音通知消息限制在100字以内，确保信息传达高效。
个性化语音: 支持VOICEVOX的“ずんだもん”及其他可用角色的语音播报。
跨平台支持: 兼容Windows、Mac和Linux操作系统。
工具集成: 作为MCP服务器，它向LLM客户端提供一个可调用的语音通知工具。

安装步骤

安装Node.js: 确保您的系统已安装Node.js 18.0.0或更高版本。您可以访问Node.js官网下载并安装。
安装VOICEVOX:
- 从VOICEVOX官网下载并安装VOICEVOX应用程序。
- 启动VOICEVOX应用程序，它默认会在 'http://localhost:50021' 端口运行。请确保VOICEVOX正常运行。

安装MCP服务器包: 打开命令行工具（如PowerShell, Terminal等），运行以下命令全局安装此MCP服务器包：

npm install -g @tenormusica/mcp-voicevox-notification

服务器配置

要让您的MCP客户端（例如Claude Code）使用此语音通知服务，您需要在客户端的MCP配置文件中添加相应的服务器配置。

Windows用户: 编辑 '%APPDATA%.claude\claude_desktop_config.json'
Mac用户: 编辑 '~/Library/Application Support/Claude/claude_desktop_config.json' 在 'mcpServers' 部分添加以下内容：

{
  "mcpServers": {
    "voicevox": {
      "command": "npx",
      "args": ["@tenormusica/mcp-voicevox-notification"]
    }
    // "voicevox": 这是您为该MCP服务器定义的名称，LLM客户端将通过此名称引用它。
    // "command": 启动MCP服务器的命令，这里使用'npx'来运行全局安装的npm包。
    // "args": 传递给'command'命令的参数，指定要运行的MCP通知包的名称。
  }
}

基本使用方法

配置完成后，在Claude Code或其他支持MCP的LLM客户端中执行任务时，您可以通过调用 'notify_voice' 工具来触发语音通知。此工具接收一个包含 'message' 和 'status' 属性的对象作为参数。

任务开始时:

notify_voice({
  message: "文件的读取已开始",
  status: "start"
});

任务进行中:

notify_voice({
  message: "数据正在处理中",
  status: "progress"
});

任务完成时:

notify_voice({
  message: "所有文件已成功处理",
  status: "complete"
});

任务出错时:

notify_voice({
  message: "未找到文件",
  status: "error"
});

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息