MCP Server
Whisper CLI MCP Server
An MCP server that provides shell command execution and OpenAI Whisper transcription capabilities for audio files.
0
GitHub Stars
8/10/2025
Last Updated
MCP Server Configuration
1{
2 "name": "whisper-cli-mcp",
3 "command": "python",
4 "args": [
5 "/path/to/whisper-cli-mcp/server.py"
6 ]
7}
JSON7 lines
README Documentation
Whisper CLI MCP Server
An MCP server that provides shell command execution and OpenAI Whisper transcription capabilities.
Features
- whisper_transcribe: Transcribe audio files using OpenAI Whisper
- shell_command: Execute shell commands safely with basic security validation
Installation
- Install dependencies:
pip install -r requirements.txt
- Make the server executable:
chmod +x server.py
Usage
Running the Server
python server.py
Tools Available
whisper_transcribe
Transcribe audio files using whisper-cli.
Parameters:
audio_file
(required): Path to the audio filemodel
(optional): Whisper model (base, small, medium, large, large-v2, large-v3)language
(optional): Language code for transcriptionoutput_format
(optional): Output format (txt, vtt, srt, json)
shell_command
Execute shell commands with basic security validation.
Parameters:
command
(required): Shell command to executeworking_directory
(optional): Working directory for the command
Security
The shell_command tool includes basic security validation to prevent execution of potentially dangerous commands. Commands containing the following patterns are blocked:
rm -rf
sudo
chmod 777
dd if=
> /dev/
Configuration
To use this server with Claude Desktop, add the following to your claude_desktop_config.json
:
{
"mcpServers": {
"whisper-cli-mcp": {
"command": "python",
"args": ["/path/to/whisper-cli-mcp/server.py"]
}
}
}
Quick Install
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source