Voice Status Report MCP Server

Voice Status Report MCP 服务

一个基于 OpenAI 的文本转语音 API 提供语音状态更新的 Model Context Protocol（MCP）服务。这让大模型能够通过简短的语音消息与用户交流：报告任务进度，或确认命令已执行。在使用 Cursor 或 Claude code 时尤其有用：你可以给 Agent 分配任务，然后去做别的事情，同时继续收到 Agent 的进度报告，并在任务完成、需要你关注时收到通知。

这个 MCP 服务力求开箱即用：summarize 工具的描述（大多数 MCP 客户端会将其添加到系统消息前面）会要求模型使用此工具报告任务进度。

可用工具

此服务提供以下工具：

• summarize(text: str)：使用 OpenAI 的 TTS API 将提供的文本转换为语音，并播放给用户。适用于在代码更改或命令执行后提供状态更新或确认。

用法

使用此服务需要 OpenAI API 密钥。

Claude for Desktop

更新 claude_desktop_config.json（macOS 上位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json，Windows 上位于 %APPDATA%/Claude/claude_desktop_config.json），加入以下内容：

{
  "mcpServers": {
    "voice-status-report": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

命令行选项

此服务接受以下命令行选项：

• --ding：启用每条语音消息播放前的提示音。默认情况下，提示音处于禁用状态。
• --voice [VOICE]：选择语音生成所用的声音。可选项：alloy、ash、coral（默认）、echo、fable、onyx、nova、sage、shimmer。
• --speed SPEED：设置语速（0.5-4.0，数值越大语速越快）。默认值为 4.0。
• --instructions TEXT：为 TTS 模型提供自定义语音指令。默认情况下，此服务使用预设指令生成平静、友好的声音。

示例

# Run with ding sound enabled and a different voice
voice-status-report-mcp-server --ding --voice nova

# Run with a slower speech speed
voice-status-report-mcp-server --speed 2.0

# Run with custom voice instructions
voice-status-report-mcp-server --instructions "Voice should be confident and authoritative"

Claude for Desktop 配置示例

{
  "mcpServers": {
    "voice-status-calm": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server",
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    },
  }
}

使用非默认参数时，可以使用以下配置：

{
  "mcpServers": {
    "voice-status-report-mcp-server": {
      "command": "uvx",
      "args": [
        "voice-status-report-mcp-server",
        "--ding",
        "--voice", "nova",
        "--speed", "3.0",
        "--instructions", "Voice should be confident and authoritative"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY"
      }
    }
  }
}

使用示例

连接后，Claude 可以使用此工具提供音频反馈，例如：

• “添加了一个用于处理用户身份验证的新函数”
• “修复了登录表单中的错误”
• “为 API 客户端创建了一个新文件”
• “添加了 OpenAI TTS 文档链接”

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。