{"_id":"@clawbow/mcp-whisper","_rev":"4-3157b43c545746d39072a2cdc28b2e01","name":"@clawbow/mcp-whisper","dist-tags":{"latest":"1.1.4"},"versions":{"1.1.0":{"name":"@clawbow/mcp-whisper","version":"1.1.0","keywords":["mcp","whisper","transcription","openai","claude","model-context-protocol"],"author":{"name":"DarkBow"},"license":"MIT","_id":"@clawbow/mcp-whisper@1.1.0","maintainers":[{"name":"clawbow","email":"openclaw@bowverse.fr"}],"homepage":"https://github.com/clawbow/mcp-whisper#readme","bugs":{"url":"https://github.com/clawbow/mcp-whisper/issues"},"bin":{"mcp-whisper":"index.js"},"dist":{"shasum":"6c5a8ef0bce0075aa85bfcf97336946e4876e294","tarball":"https://registry.npmjs.org/@clawbow/mcp-whisper/-/mcp-whisper-1.1.0.tgz","fileCount":5,"integrity":"sha512-xzBM6XCjZyPNZ4PgkPpQhnq0ekFXVoKnEmwV2go58F1bxAOzbHsTgVEhgRMckaewQO3Can57bvnnyF2Lfujk7A==","signatures":[{"sig":"MEUCICvkq06VxTPrEzbVNcSan9zf+ND16rsRX48CsSTzzf6qAiEA+R7AWYa1xFSm1TmJqlQGXjJGUgh2+H5wvvICv2iaoYE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17818},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"36f334274230df361098e055676ddbbbfa07f93d","scripts":{"test":"echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node index.js","setup":"node setup.js","start":"node index.js"},"_npmUser":{"name":"clawbow","email":"openclaw@bowverse.fr"},"repository":{"url":"git+https://github.com/clawbow/mcp-whisper.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for audio transcription with OpenAI API, whisper-cli, or whisper.cpp","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-whisper_1.1.0_1774445815651_0.5190303878008562","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@clawbow/mcp-whisper","version":"1.1.2","keywords":["mcp","whisper","transcription","openai","claude","model-context-protocol"],"author":{"name":"DarkBow"},"license":"MIT","_id":"@clawbow/mcp-whisper@1.1.2","maintainers":[{"name":"clawbow","email":"openclaw@bowverse.fr"}],"homepage":"https://github.com/clawbow/mcp-whisper#readme","bugs":{"url":"https://github.com/clawbow/mcp-whisper/issues"},"bin":{"mcp-whisper":"index.js","mcp-whisper-setup":"setup.js"},"dist":{"shasum":"289fae3d1c48f7a4fcb066d95e5e8102bc0aff43","tarball":"https://registry.npmjs.org/@clawbow/mcp-whisper/-/mcp-whisper-1.1.2.tgz","fileCount":5,"integrity":"sha512-3q0gDdXgrs3y2R8cYc7nWngPqiYK88Q98i9MR7HkThEvKJk65fz0CgXeBUOGldDeW6tqRPLHBt6yB6ILionQgA==","signatures":[{"sig":"MEQCIG+jpY1xX6/XNIRi2kjDmw+mioqDmnD1Sn+oDm2pZra3AiBpON+spbThjkxzRcmmX+rBpm5c3FKHY18pbaPTdYtgRA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17857},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"36f334274230df361098e055676ddbbbfa07f93d","scripts":{"test":"echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node index.js","setup":"node setup.js","start":"node index.js"},"_npmUser":{"name":"clawbow","email":"openclaw@bowverse.fr"},"repository":{"url":"git+https://github.com/clawbow/mcp-whisper.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for audio transcription with OpenAI API, whisper-cli, or whisper.cpp","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-whisper_1.1.2_1774446956459_0.5910080076120172","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"@clawbow/mcp-whisper","version":"1.1.3","keywords":["mcp","whisper","transcription","openai","claude","model-context-protocol"],"author":{"name":"DarkBow"},"license":"MIT","_id":"@clawbow/mcp-whisper@1.1.3","maintainers":[{"name":"clawbow","email":"openclaw@bowverse.fr"}],"homepage":"https://github.com/clawbow/mcp-whisper#readme","bugs":{"url":"https://github.com/clawbow/mcp-whisper/issues"},"bin":{"mcp-whisper":"index.js","mcp-whisper-setup":"setup.js"},"dist":{"shasum":"50133c0284dfb02ae00b78e042c423971ab8e52e","tarball":"https://registry.npmjs.org/@clawbow/mcp-whisper/-/mcp-whisper-1.1.3.tgz","fileCount":5,"integrity":"sha512-dLbyCmxakH59VHvVnJsYCorbsaSDOR9JdfvGJMqPNlUmiEwpAILt3qJOPiwQCwNBUgvuJKJ4DMGaT0ZOOU3mhQ==","signatures":[{"sig":"MEUCIQCM9ZU1gJlijQo6hXZe3Myxen+qxQO8d/fEe2h79HnO0AIgJRv5iJ48pdP8e+nrhIcF5RZRBn4dk1HUa+LnZoh5Av8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18767},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"36f334274230df361098e055676ddbbbfa07f93d","scripts":{"test":"echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node index.js","setup":"node setup.js","start":"node index.js"},"_npmUser":{"name":"clawbow","email":"openclaw@bowverse.fr"},"repository":{"url":"git+https://github.com/clawbow/mcp-whisper.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for audio transcription with OpenAI API, whisper-cli, or whisper.cpp","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-whisper_1.1.3_1774447745205_0.36335275350024365","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"@clawbow/mcp-whisper","version":"1.1.4","description":"MCP server for audio transcription with OpenAI API, whisper-cli, or whisper.cpp","type":"module","main":"index.js","bin":{"mcp-whisper":"index.js","mcp-whisper-setup":"setup.js"},"scripts":{"start":"node index.js","setup":"node setup.js","test":"echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node index.js"},"keywords":["mcp","whisper","transcription","openai","claude","model-context-protocol"],"author":{"name":"DarkBow"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/clawbow/mcp-whisper.git"},"bugs":{"url":"https://github.com/clawbow/mcp-whisper/issues"},"homepage":"https://github.com/clawbow/mcp-whisper#readme","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"engines":{"node":">=18.0.0"},"gitHead":"36f334274230df361098e055676ddbbbfa07f93d","_id":"@clawbow/mcp-whisper@1.1.4","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-/VuiK1MMnTuk50q+JSoKirf3a1kX/+YAfobexn+xqhscUPOgwtdKZEfj9hsC93BNY58d7BlxVtLU4uiuJltfoA==","shasum":"cd42a574eef37e17824d04fd424c965394ece2a7","tarball":"https://registry.npmjs.org/@clawbow/mcp-whisper/-/mcp-whisper-1.1.4.tgz","fileCount":5,"unpackedSize":20937,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIElRs+iaOyttuCpsPHTI8lGpFoHPqGduD4sgySuuS7U3AiAak4yIZWNCKn6K5SasbJLVjjzsBDUhB9p/lxNxyubuQg=="}]},"_npmUser":{"name":"clawbow","email":"openclaw@bowverse.fr"},"directories":{},"maintainers":[{"name":"clawbow","email":"openclaw@bowverse.fr"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-whisper_1.1.4_1774448078010_0.5758728183690722"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T13:36:55.556Z","modified":"2026-03-25T14:14:38.252Z","1.1.0":"2026-03-25T13:36:55.806Z","1.1.2":"2026-03-25T13:55:56.589Z","1.1.3":"2026-03-25T14:09:05.350Z","1.1.4":"2026-03-25T14:14:38.153Z"},"bugs":{"url":"https://github.com/clawbow/mcp-whisper/issues"},"author":{"name":"DarkBow"},"license":"MIT","homepage":"https://github.com/clawbow/mcp-whisper#readme","keywords":["mcp","whisper","transcription","openai","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/clawbow/mcp-whisper.git"},"description":"MCP server for audio transcription with OpenAI API, whisper-cli, or whisper.cpp","maintainers":[{"name":"clawbow","email":"openclaw@bowverse.fr"}],"readme":"# 🎙️ MCP Whisper\n\n[![npm version](https://badge.fury.io/js/@clawbow%2Fmcp-whisper.svg)](https://www.npmjs.com/package/@clawbow/mcp-whisper)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP (Model Context Protocol) server for audio transcription with multiple providers:\n- 🌐 **OpenAI API** - Cloud-based, accurate\n- 🖥️ **whisper-cli** - Local Python version\n- ⚡ **whisper.cpp** - Fast C++ implementation\n\n## Installation\n\n### Global install (recommended)\n```bash\nnpm install -g @clawbow/mcp-whisper\n```\n\n### Local install\n```bash\nnpm install @clawbow/mcp-whisper\nnpx mcp-whisper\n```\n\n## Quick Setup\n\n```bash\n# Check dependencies and setup\nnpx mcp-whisper-setup\n\n# Or auto-install whisper-cli\nnpx mcp-whisper-setup --auto\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"whisper\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@clawbow/mcp-whisper\"],\n      \"env\": {\n        \"OPENAI_API_KEY\": \"sk-...\",\n        \"WHISPER_PROVIDER\": \"auto\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENAI_API_KEY` | OpenAI API key | - |\n| `WHISPER_PROVIDER` | Provider: `openai`, `local`, `whisper-cli`, `auto` | `auto` |\n| `WHISPER_LOCAL_URL` | URL for whisper.cpp server | `http://localhost:8080/inference` |\n| `WHISPER_CLI_PATH` | Path to whisper binary | `whisper` |\n\n## Providers\n\n### 1. OpenAI API (easiest)\n```bash\nexport OPENAI_API_KEY=\"sk-...\"\nexport WHISPER_PROVIDER=\"openai\"\nnpx @clawbow/mcp-whisper\n```\n\n### 2. whisper-cli (local Python)\nInstall:\n```bash\npip install -U openai-whisper\n# Also needs ffmpeg\nbrew install ffmpeg  # Mac\nsudo apt install ffmpeg  # Ubuntu\n```\n\n### 3. whisper.cpp (fastest local)\n```bash\ngit clone https://github.com/ggerganov/whisper.cpp.git\ncd whisper.cpp\nmake\n./models/download-ggml-model.sh base\n./server -m models/ggml-base.bin --port 8080\n```\n\n## Available Tools\n\n### `transcribe_audio`\n```json\n{\n  \"audio_path\": \"/path/to/audio.wav\",\n  \"language\": \"fr\",\n  \"provider\": \"auto\"\n}\n```\n\n### `transcribe_audio_base64`\n```json\n{\n  \"audio_base64\": \"base64encoded...\",\n  \"filename\": \"audio.wav\",\n  \"language\": \"fr\",\n  \"provider\": \"auto\"\n}\n```\n\n### `list_providers`\nList available providers and their status.\n\n## Auto-Detection\n\nWhen `provider: \"auto\"`, the server tries in order:\n1. OpenAI API (if `OPENAI_API_KEY` is set)\n2. whisper-cli (if `whisper` is in PATH)\n3. whisper.cpp local server (if responding on port 8080)\n\n## Usage Example\n\nIn Claude Desktop, you can say:\n> \"Transcribe this audio file: /path/to/meeting.wav\"\n\nClaude will automatically use the available whisper provider.\n\n## License\n\nMIT © DarkBow\n","readmeFilename":"README.md"}