Voice Recorder MCP Server

Features

• Record audio from the default microphone

• Transcribe recordings using Whisper

• Integrates with Goose AI agent as a custom extension

• Includes prompts for common recording scenarios

Installation

Usage

As a Standalone MCP Server

Testing with MCP Inspector

With Goose AI Agent

1. Open Goose and go to Settings > Extensions > Add > Command Line Extension

2. Set the name to `voice-recorder`

3. In the Command field, enter the full path to the voice-recorder-mcp executable: ``` /full/path/to/voice-recorder-mcp ``` Or for a specific model: ``` /full/path/to/voice-recorder-mcp --model medium.en ``` To find the path, run: ```bash which voice-recorder-mcp ```

4. No environment variables are needed for basic functionality

5. Start a conversation with Goose and introduce the recorder with: "I want you to take action from transcriptions returned by voice-recorder. For example, if I dictate a calculation like 1+1, please return the result."

Available Tools

• `start_recording`: Start recording audio from the default microphone

• `stop_and_transcribe`: Stop recording and transcribe the audio to text

• `record_and_transcribe`: Record audio for a specified duration and transcribe it

Whisper Models

Requirements

• Python 3.12+

• An audio input device (microphone)

Configuration

Troubleshooting

Common Issues

• **No audio being recorded**: Check your microphone permissions and settings

• **Model download errors**: Ensure you have a stable internet connection for the initial model download

• **Integration with Goose**: Make sure the command path is correct

• **Audio quality issues**: Try adjusting the sample rate (default: 16000)

Contributing

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add some amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request

License