genpark-voice-vad

genpark-voice-vad

用于语音轮次端点检测的能量和转录文本启发式方法。

这是一个基于预先计算的分贝能量和转录文本的启发式端点检测器。它不会解码音频、转录语音，也不会运行经过训练的 VAD 模型。置信度值是启发式评分，并非经过校准的概率。

从 GitHub 发行版安装

需要 Python 3.9 或更高版本。该库和 stdio MCP 服务没有运行时依赖。

python -m pip install https://github.com/Alpha-Park/genpark-voice-turn-taking-endpoint-detector-skill/releases/download/v1.0.1/genpark_voice_vad-1.0.1-py3-none-any.whl

PyPI 发布仍待账号设置完成。计划发布到 PyPI 的项目为 genpark-voice-vad； 在项目发布前，请勿假定 pip install genpark-voice-vad 可用。

Python 用法

from genpark_voice_vad import VoiceTurnTakingEndpointDetector
client = VoiceTurnTakingEndpointDetector()
print(client.run_benchmark_turn_detection())

MCP stdio 配置

安装 wheel 后，使用已安装的命令配置 MCP 客户端：

{
  "mcpServers": {
    "genpark-voice-vad": {
      "command": "genpark-voice-vad",
      "args": []
    }
  }
}

如果该命令不在 PATH 中，请使用其绝对路径，或使用安装 wheel 时所用的同一解释器运行 python -m genpark_voice_vad。 GitHub 发行版还包含一个 .mcpb 捆绑包，供支持桌面扩展的客户端使用。 该捆绑包需要 PATH 中有 Python 3.9 或更高版本的解释器；其中包含服务源代码。

可用工具：analyze_turn_status、calibrate_acoustic_thresholds、predict_semantic_closure、run_benchmark_turn_detection。 tools/list 会返回必需参数和 JSON 架构。 每个 MCP 进程都持有独立状态。基准测试工具使用隔离实例。

开发

python -m unittest discover -s tests
python -m pip install mcp
python tests/check_mcp.py
python -m pip install build twine
python -m build
python -m twine check dist/*

python mcp_server.py --test 会运行确定性示例；它不是协议一致性测试。 MCP 客户端检查会通过 stdio 测试 initialize、tools/list、tools/call 和 ping。

分发

在配置 PyPI 之前，GitHub 源代码和发行版构件是主要分发渠道。 注册表提交会单独跟踪；清单并不能证明注册表已接受提交。 有关可重复执行的 PyPI 工作流，请参阅 PUBLISHING.md。

MIT 许可证。由 GenPark 维护。