语音转录服务器

一个用于录制音频并使用OpenAI的Whisper模型进行转录的MCP服务器,可作为Goose自定义扩展或独立MCP服务器使用。

  • by DefiBax
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 defibax/mcp_servers

使用说明

录音机MCP服务器

一个MCP服务器,用于录制音频并使用OpenAI的Whisper模型进行转录。设计为Goose自定义扩展或独立MCP服务器。

特性

  • 从默认麦克风录制音频
  • 使用Whisper转录录音
  • 作为自定义扩展与Goose AI代理集成
  • 包括常见录制场景的提示

安装

# Install from source
git clone https://github.com/DefiBax/voice-recorder-mcp.git
cd voice-recorder-mcp
pip install -e .

用法

作为独立的MCP服务器

# Run with default settings (base.en model)
voice-recorder-mcp

# Use a specific Whisper model
voice-recorder-mcp --model medium.en

# Adjust sample rate
voice-recorder-mcp --sample-rate 44100

MCP检验员测试

MCP检查器提供了一个交互式界面来测试您的服务器:

# Install the MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Run your server with the inspector
npx @modelcontextprotocol/inspector voice-recorder-mcp

使用Goose AI代理

  1. 打开Goose,进入“设置”>“扩展”>“添加”>“命令行扩展”

  2. 将名称设置为 voice-recorder

  3. 在命令字段中,输入录音机mcp可执行文件的完整路径:

    /full/path/to/voice-recorder-mcp
    

    或者对于特定型号:

    /full/path/to/voice-recorder-mcp --model medium.en
    

    要查找路径,请运行:

    which voice-recorder-mcp
    
  4. 基本功能不需要环境变量

  5. 与Goose开始对话,并介绍录音机: 我希望您从录音机返回的转录中采取行动。例如,如果我口述了1+1这样的计算,请返回结果

可用工具

  • start_recording:从默认麦克风开始录制音频
  • stop_and_transcribe:停止录制并将音频转录为文本
  • record_and_transcribe:在指定的持续时间内录制音频并转录

Whisper型号

此扩展支持各种Whisper型号尺寸:

型号 速度 精度 内存使用情况 用例
tiny.en 最快 最低 最低 测试,快速转录
base.en 快速 良好 低 日常使用(默认)
small.en 中等 较好 中等 平衡良好
medium.en 慢 高 高 重要录音
large 最慢 最高 非常高 临界转录

这 .en 后缀表示专门用于英语的模型,这些模型对英语内容更快、更准确。

需求

  • Python 3.12+
  • 音频输入设备(麦克风)

配置

您可以使用环境变量配置服务器:

# Set Whisper model
export WHISPER_MODEL=small.en

# Set audio sample rate
export SAMPLE_RATE=44100

# Set maximum recording duration (seconds)
export MAX_DURATION=120

# Then run the server
voice-recorder-mcp

故障排除

常见问题

  • 未录制音频:检查您的麦克风权限和设置
  • 模型下载错误:确保您在初始型号下载时有稳定的互联网连接
  • 与Goose集成:确保命令路径正确
  • 音频质量问题:尝试调整采样率(默认值:16000)

贡献

欢迎投稿!请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。