WhatsApp音频转录服务

一个通过OpenAI Whisper API转录WhatsApp音频消息的Model Context Protocol (MCP)服务器。

  • by GBurgardt
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 GBurgardt/mcp-whatsapp-whisper

使用说明

MCP-WhatsApp-私密消息(或悄悄话)

模型上下文协议(MCP)服务器,用于展示WhatsApp音频消息并使用OpenAI的Whisper API进行转录。

要求

  • 搭载WhatsApp桌面版的macOS(该项目读取本地WhatsApp的SQLite数据库和媒体文件)
  • Node.js 18及以上版本
  • ffmpeg(brew install ffmpeg) 用于 .opus → .mp3 需要时进行转换
  • OpenAI API密钥可作为环境变量使用 OPENAI_API_KEY

安装

npm install
npm run build

环境

在启动服务器之前设置OpenAI API密钥。例如:

export OPENAI_API_KEY="sk-your-openai-key"

使用PM2运行

export OPENAI_API_KEY="sk-your-openai-key"
pm2 start ecosystem.config.cjs

光标配置

添加到你的光标设置中(~/.cursor/mcp.json):

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

工具

  • 获取最近音频从联系人处获取最近的音频文件
  • 搜索音频按联系人姓名或日期搜索音频文件
  • 转录音频通过OpenAI Whisper转录音频whisper-1)

许可证

麻省理工学院(MIT)