MCP server · App Intents · CLI
每项功能都可以由 AI 助手调用。一切都在 Mac 本地运行——AI 发出请求,LocalVoice 完成工作,LocalVoice 不会上传任何内容。
打开 LocalVoice → 设置 → AI → 连接。然后重启 AI 应用。
设置 → AI → 拷贝命令,然后粘贴到终端。
操作会出现在“快捷指令”App 的 LocalVoice 分类下。
手动配置 MCP:
{
"mcpServers": {
"localvoice": {
"command": "/Applications/LocalVoice.app/Contents/MacOS/localvoice",
"args": ["mcp"]
}
}
}
工具名称和说明以英文显示——与你的 AI 助手收到的内容完全一致。
| 工具 | 作用 | 会改动文件? |
|---|---|---|
transcribe | Transcribe an audio or video file — or every file in a folder — on this Mac. Files over ~90 s and folders run as a background job (returns job_id; poll job_status). Always saves a Markdown transcript to the LocalVoice library; 'formats' also writes txt/srt/vtt/md files next to the source (or to output_dir). Use srt or vtt for subtitles. Returns the transcript text (truncated if long) and file paths. Long files can take minutes. | 是 |
job_status | Progress and results of a background transcription job (job_id from transcribe, or "latest"). Read-only. | 否 |
cancel_job | Stop a background transcription job (job_id from transcribe, or "latest"). Files already finished are kept. | 是 |
list_media | List audio/video files in a folder (default ~/Downloads), optionally only those added since a date. Use before transcribe when the user describes a recording by date ("yesterday's meeting"). Read-only. | 否 |
read_aloud | Turn text, a text/Markdown file, or a PDF into a spoken M4A audio file using the Mac's built-in voices (offline). Give 'path' or 'text'. The voice is chosen automatically from the text's language unless 'voice' is set (see list_voices). | 是 |
list_voices | List the Mac's installed speech voices, best quality first, optionally for one language (e.g. "en", "vi"). Read-only. | 否 |
search_transcripts | Find where a word or phrase was said across saved transcripts (case- and accent-insensitive). Returns transcript, timestamp and the surrounding sentences. Read-only. | 否 |
list_transcripts | List saved transcripts, newest first. Read-only. | 否 |
get_transcript | Get the full text of a saved transcript ("latest" for the newest, an id, or part of the title), with timestamps. Use this to summarise or quote a recording. Read-only. | 否 |
download_model | Download a Whisper speech model (needed for Vietnamese and other languages Apple's engine lacks). base ~150 MB (fast), small ~490 MB, turbo ~550 MB (best). Downloads from Hugging Face once; transcription itself stays offline. Ask the user before downloading. | 是 |
localvoice list localvoice transcribe --path ~/Downloads/meeting.m4a --formats srt