Voice Status Report MCP Server

MCP服务器语音状态报告

A. 模型上下文协议 （MCP）服务器，通过以下方式提供语音状态更新 OpenAI的文本到速度API这允许语言模型通过短语音消息与用户通信：报告任务的进度，或确认命令已被执行。在使用Cursor或Claude代码时，它特别有用：你可以给代理一个任务，继续做其他事情，但要不断收到代理进度的状态报告，以及何时完成任务并需要你的注意。

此MCP服务器应包括电池： summarize 工具（大多数MCP客户端都会将其添加到系统消息中）要求模型使用此工具报告任务的进度。

可用工具

服务器公开了以下工具：

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

用法

您需要一个OpenAI API密钥才能使用此服务器。

Claude桌面版

更新您的 claude_desktop_config.json （位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json 在macOS和 %APPDATA%/Claude/claude_desktop_config.json 在Windows上）包括以下内容：

{
  "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桌面配置示例

{
  "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许可证获得许可-有关详细信息，请参阅许可证文件。