Local Transcribe
English
下载

CLI 与 MCP

同一份本地服务，换一个入口。

命令行

local-transcribe 是共享服务的客户端。所有命令输出 JSON；服务没起来时会自动拉起一个。

查看服务状态与模型
local-transcribe status
local-transcribe models list
在本机提交一个转写任务
local-transcribe jobs add ./录音.m4a --root ~/录音
指定局域网节点，失败也不回退
local-transcribe jobs add ./录音.m4a --node Gaming-PC --lan-model <模型 ID>
查看任务并导出
local-transcribe jobs list
local-transcribe export <任务 ID> --format txt --output ./稿子.txt

退出码

  • 0：成功
  • 1：请求失败
  • 2：用法错误
  • 4：服务不可用

MCP

voice-to-text-mcp 通过本地 stdio 说话 MCP 协议，是共享服务的另一个客户端。模型不在 MCP 进程里加载。

  • 提交转写，立即返回任务 ID；之后轮询状态与结果。
  • 列出任务与模型，取消、重试、导出结果（TXT 或 JSON）。
  • 文件访问是 fail-closed：输入与导出目录必须落在显式声明的允许根目录里，没有根目录一律拒绝。
  • 没有网络监听、没有任意文件访问、没有 shell 执行。
工具清单随版本变化，以仓库里的 docs/mcp.md 为准。

GUI、CLI 与 MCP 连的是同一个文件存储的服务实例。在一边开始的任务，在另外两边都能看到。