MCP

让 MCP 客户端直连本地转录。

已可用——MCP 随 edgespeak-cli 以 stdio 方式提供；桌面 App 运行时，本地网关同时提供 HTTP 形式的 MCP。

接入

任何支持 stdio 服务器的 MCP 客户端都能接。先安装并激活 edgespeak-cli，然后注册 EdgeSpeak——以 Claude Code 为例：

claude mcp add edgespeak -- edgespeak-cli mcp

CLI 安装指南

通道

App 开着就经本地网关复用它已加载的模型，没开就自己拉起随附的本地引擎。桌面 App 运行时，本地网关还提供 HTTP 形式的 MCP，用同一把 Bearer key。

edgespeak-cli mcp                   # stdio
POST http://127.0.0.1:1117/mcp      # HTTP（桌面 App 运行时）

工具

五个只读工具。本地模型缺失时返回 tool error，稳定码为 model_downloading 或 model_not_downloaded。

edgespeak_transcribe_file    必填: path（绝对路径）
                             可选: model, timestamps (none|word|segment),
                                   min_chars, max_chars, start_margin, end_margin

edgespeak_transcribe         必填: audio_base64（解码后 ≤ 50MB）
                             可选: 同 transcribe_file

edgespeak_align              必填: text + path | audio_base64 二选一
                             可选: protected_terms

edgespeak_segment_sentences  必填: text 或 segments[]
                             可选: threshold (默认 0.35), min_chars, max_chars,
                                   start_margin, end_margin

edgespeak_list_models        无参数 → {models: [{id, owned_by, locality}]}

结果

工具结果 2000 字符内直接内联；超长输出落盘为本地 artifact 文件，内联保留预览。

≤ 2000 字符  →  { "metadata": …, "result": …, "truncated": false }
> 2000 字符  →  { "metadata": …, "preview": { "head": …, "tail": … },
                  "artifact_path": …, "artifact_json_path": …, "truncated": true }

隐私

与其它能力同一条本地优先规则：音频在本机处理，绝不上传。