JUHE API Marketplace
yhsung avatar
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

  1. Install dependencies:
pip install -r requirements.txt
  1. 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 file
  • model (optional): Whisper model (base, small, medium, large, large-v2, large-v3)
  • language (optional): Language code for transcription
  • output_format (optional): Output format (txt, vtt, srt, json)

shell_command

Execute shell commands with basic security validation.

Parameters:

  • command (required): Shell command to execute
  • working_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