whisper-mcp

Whisper MCP 服务

一个轻量级的 MCP（模型上下文协议）服务，使用 whisper.cpp 在本地转录音频。目前已有多个 Whisper MCP 实现。这个实现精简小巧，可与 apple-voice-memo-mcp 搭配，构建完整的语音备忘录工作流。

功能

• 本地转录 - 所有处理都在你的设备上完成
• 多种模型 - 可选择 tiny、base、small、medium 或 large 模型
• 多种格式 - 支持 wav、mp3、m4a 和其他音频格式
• 时间戳 - 获取带或不带时间戳的转录文本

要求

• macOS（已在 Apple Silicon 上测试）
• Node.js 18+
• whisper-cpp：brew install whisper-cpp
• ffmpeg：brew install ffmpeg

安装

npm install -g whisper-mcp

或直接运行：

npx whisper-mcp

配置

Claude Desktop

将以下内容添加到 Claude Desktop 配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "whisper-mcp": {
      "command": "npx",
      "args": ["-y", "whisper-mcp"]
    }
  }
}

编辑后，重启 Claude Desktop。

Claude Code（命令行）

对于 Claude Code，将以下内容添加到项目的 .mcp.json 文件：

{
  "mcpServers": {
    "whisper-mcp": {
      "command": "npx",
      "args": ["-y", "whisper-mcp"]
    }
  }
}

也可以添加到 ~/.claude/settings.json，以应用于整个用户配置：

{
  "mcpServers": {
    "whisper-mcp": {
      "command": "npx",
      "args": ["-y", "whisper-mcp"]
    }
  }
}

提示：在 Claude Code 中使用 /mcp 验证服务是否已连接。

本地开发环境设置

如果从源码运行，而不是通过 npm 运行：

{
  "mcpServers": {
    "whisper-mcp": {
      "command": "node",
      "args": ["/path/to/whisper-mcp/dist/index.js"]
    }
  }
}

搭配 Apple Voice Memos MCP 使用

如需构建完整的语音备忘录工作流，可搭配 apple-voice-memo-mcp 使用：

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    },
    "whisper-mcp": {
      "command": "npx",
      "args": ["-y", "whisper-mcp"]
    }
  }
}

MCP 工具

transcribe_audio

使用 Whisper 转录音频文件。

参数：

• file_path（必填）：音频文件的绝对路径
• model（可选）：要使用的模型（tiny.en、base.en、small.en、medium.en、large）。默认值：base.en
• language（可选）：语言代码。默认值：en
• output_format（可选）：text、timestamps 或 json。默认值：text

示例：

{
  "file_path": "/path/to/audio.m4a",
  "model": "medium.en",
  "output_format": "timestamps"
}

list_whisper_models

列出可用的 Whisper 模型及其下载状态。

返回：

{
  "models": [
    {
      "name": "base.en",
      "size": "142 MB",
      "downloaded": true,
      "path": "/Users/you/.whisper/ggml-base.en.bin"
    }
  ]
}

download_whisper_model

下载 Whisper 模型以供本地使用。

参数：

• model（必填）：要下载的模型（tiny.en、base.en、small.en、medium.en、large）

模型

模型	大小	速度	质量
tiny.en	75 MB	最快	基本
base.en	142 MB	快	良好
small.en	466 MB	中等	更好
medium.en	1.5 GB	慢	很好
large	2.9 GB	最慢	最佳

模型存储在 ~/.whisper/ 中。

工作流示例

1. 列出语音备忘录：list_voice_memos
2. 获取音频路径：使用备忘录 ID 调用 get_audio
3. 转录：使用文件路径调用 transcribe_audio
4. 保存到你的知识库

开发

# Clone and install
git clone https://github.com/jwulff/whisper-mcp.git
cd whisper-mcp
npm install

# Build
npm run build

# Test with MCP inspector
npm run inspector

许可证

MIT