Tidyware

MCP server · App Intents · CLI

LocalVoice
AI 智能体接入

每项功能都可以由 AI 助手调用。一切都在 Mac 本地运行——AI 发出请求,LocalVoice 完成工作,LocalVoice 不会上传任何内容。

一键连接

03

Claude Desktop / Cursor

打开 LocalVoice → 设置 → AI → 连接。然后重启 AI 应用。

Claude Code

设置 → AI → 拷贝命令,然后粘贴到终端。

Siri 与快捷指令

操作会出现在“快捷指令”App 的 LocalVoice 分类下。

手动配置 MCP:

{
  "mcpServers": {
    "localvoice": {
      "command": "/Applications/LocalVoice.app/Contents/MacOS/localvoice",
      "args": ["mcp"]
    }
  }
}

工具

10

工具名称和说明以英文显示——与你的 AI 助手收到的内容完全一致。

工具作用会改动文件?
transcribeTranscribe 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_statusProgress and results of a background transcription job (job_id from transcribe, or "latest"). Read-only.否
cancel_jobStop a background transcription job (job_id from transcribe, or "latest"). Files already finished are kept.是
list_mediaList 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_aloudTurn 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_voicesList the Mac's installed speech voices, best quality first, optionally for one language (e.g. "en", "vi"). Read-only.否
search_transcriptsFind where a word or phrase was said across saved transcripts (case- and accent-insensitive). Returns transcript, timestamp and the surrounding sentences. Read-only.否
list_transcriptsList saved transcripts, newest first. Read-only.否
get_transcriptGet 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_modelDownload 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.是

请求示例

05

命令行

CLI
localvoice list
localvoice transcribe --path ~/Downloads/meeting.m4a --formats srt