Voice Status Report MCP Server

Voice Status Report MCP Server

site icon
2025.04.06 1
Python语音服务状态报告交流协作
Voice Status Report MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,利用 OpenAI 的文本转语音 API 提供语音状态更新功能。该服务允许语言模型通过短语音消息与用户交流,报告任务进度或确认命令执行情况。特别适用于与 Cursor 或 Claude 代码协作时,用户可以在执行其他任务的同时接收代理的进度报告,并在需要关注时获得通知。
View on GitHub

Overview

基本能力

产品定位

Voice Status Report MCP Server 是一个语音状态报告服务,旨在通过语音消息提供任务进度更新和命令确认。

核心功能

  • 使用 OpenAI 的文本转语音 API 将文本转换为语音并播放给用户。
  • 提供状态更新或代码更改后的确认信息。
  • 支持自定义语音参数,如声音类型、语速和语音指令。

适用场景

  • 与 Claude 或 Cursor 代码协作时,提供任务进度更新。
  • 在代码更改或命令执行后,通过语音确认操作完成。
  • 需要多任务处理时,通过语音通知用户代理的进度和需求。

工具列表

  • summarize(text: str): 将提供的文本转换为语音并播放给用户,用于提供状态更新或确认信息。

常见问题解答

  • 需要 OpenAI API 密钥才能使用该服务。
  • 支持多种声音类型和语速设置。
  • 可以通过命令行选项自定义语音参数。

使用教程

使用依赖

  • 需要安装 Python 3.12。
  • 需要 OpenAI API 密钥。

安装教程

  1. 确保已安装 Python 3.12。
  2. 安装 voice-status-report-mcp-server 包: bash pip install voice-status-report-mcp-server
  3. 配置 Claude for Desktop 的 claude_desktop_config.json 文件,添加以下内容: json { "mcpServers": { "voice-status-report": { "command": "uvx", "args": [ "voice-status-report-mcp-server" ], "env": { "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY" } } } }

调试方式

  1. 运行服务并启用 ding 声音: bash voice-status-report-mcp-server --ding --voice nova
  2. 调整语速: bash voice-status-report-mcp-server --speed 2.0
  3. 自定义语音指令: bash voice-status-report-mcp-server --instructions "Voice should be confident and authoritative"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。