使用说明
录音机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代理
-
打开Goose,进入“设置”>“扩展”>“添加”>“命令行扩展”
-
将名称设置为
voice-recorder -
在命令字段中,输入录音机mcp可执行文件的完整路径:
/full/path/to/voice-recorder-mcp或者对于特定型号:
/full/path/to/voice-recorder-mcp --model medium.en要查找路径,请运行:
which voice-recorder-mcp -
基本功能不需要环境变量
-
与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)
贡献
欢迎投稿!请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
