MCP server · App Intents · CLI
Ogni funzione può essere richiamata da un assistente IA. Tutto gira in locale sul Mac: l’IA invia una richiesta, LocalVoice fa il lavoro e LocalVoice non carica nulla online.
Apri LocalVoice → Impostazioni → IA → Connetti. Poi riavvia l’app IA.
Impostazioni → IA → Copia comando, poi incollalo nel Terminale.
Le azioni compaiono nell’app Comandi Rapidi sotto LocalVoice.
Configurazione MCP manuale:
{
"mcpServers": {
"localvoice": {
"command": "/Applications/LocalVoice.app/Contents/MacOS/localvoice",
"args": ["mcp"]
}
}
}
Nomi e descrizioni degli strumenti sono in inglese — esattamente ciò che riceve il tuo assistente IA.
| Strumento | Cosa fa | Modifica file? |
|---|---|---|
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. | Sì |
job_status | Progress and results of a background transcription job (job_id from transcribe, or "latest"). Read-only. | No |
cancel_job | Stop a background transcription job (job_id from transcribe, or "latest"). Files already finished are kept. | Sì |
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. | No |
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). | Sì |
list_voices | List the Mac's installed speech voices, best quality first, optionally for one language (e.g. "en", "vi"). Read-only. | No |
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. | No |
list_transcripts | List saved transcripts, newest first. Read-only. | No |
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. | No |
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. | Sì |
localvoice list localvoice transcribe --path ~/Downloads/meeting.m4a --formats srt