MCP 服务器

Voice Status Report MCP Server

tomekkorbak

开发者工具

README

语音状态报告 MCP 服务器

一个模型上下文协议 (MCP) 服务器，它使用 OpenAI 的文本转语音 API 提供语音状态更新。这允许语言模型通过简短的语音消息与用户进行通信：报告任务的进度，或确认命令已执行。当使用 Cursor 或 Claude 代码时，这尤其有用：您可以给代理一个任务，然后去做其他事情，但仍然可以持续收到关于代理进度的状态报告，以及代理何时完成任务并需要您的注意。

这个 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 模型提供自定义语音指令。默认情况下，服务器使用预设指令来获得平静友好的声音。

示例

# 启用叮咚声并使用不同的声音运行
voice-status-report-mcp-server --ding --voice nova

# 以较慢的语速运行
voice-status-report-mcp-server --speed 2.0

# 使用自定义语音指令运行
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"
      }
    }
  }
}