meetrecord

meetrecord

你的会议已保存在你自己的设备上的 Recordist 应用中。meetrecord 是连接到这些会议的轻量桥接工具：它通过本机回环地址与应用的本地 API 通信， 并提供九种工具，用于列出和搜索会议、 读取转录文本、查看行动项、重新生成 笔记，以及开始或停止录制。

meetrecord 本身不会将任何内容发送到设备之外——每个 请求都会发送到 Recordist 应用，由它决定如何处理。 如果应用未运行，每种工具都会明确说明 （Recordist app is not running），而不会猜测； 健康探测会先行检查，成功的探测结果会 复用五秒，因此短时间内的一连串调用不会频繁请求应用。

九种工具：

• list_meetings — 列出近期会议，可选 全文查询、from/to 日期范围，以及 limit/offset 分页。
• get_meeting — 获取一场会议及其笔记、行动项 和标记。
• get_transcript — 获取会议转录文本，格式可选 json、md、srt、vtt 或 txt（默认 md）；不支持的值 会被拒绝，并返回预期格式列表。
• search_meetings — 对转录文本和笔记进行全文搜索；查询 不能为空。
• get_action_items — 获取行动项，可选限定 某一场会议，或仅获取未完成的项。
• regenerate_notes — 使用 Recordist 中配置的提供方， 为某场会议重新运行 AI 笔记生成，也可选择指定的笔记模板。
• start_recording — 开始录制，可选指定 来源应用、标题和参会者。只有在 Recordist 的“设置”→“集成”中 启用“允许 Agent 开始录制”后，Recordist 才会 执行此操作。
• stop_recording — 停止当前录制。
• add_marker — 为当前时刻添加书签，可选 添加标签。

应用返回的错误会附带应用自身提供的消息；否则 meetrecord 会报告它收到的 HTTP 状态码。

配置

export RECORDIST_API_URL="http://127.0.0.1:47321"   # default; the app on this machine
export RECORDIST_API_TOKEN="..."                    # optional; see below
export RECORDIST_DATA_DIR="..."                     # optional; where api_token lives

身份验证使用 bearer 令牌。如果设置了 RECORDIST_API_TOKEN，则优先使用它；否则 meetrecord 会读取 RECORDIST_DATA_DIR 中的 api_token 文件，或 默认位置 ~/.local/share/app.recordist.desktop/api_token。健康探测是唯一不携带令牌发送的请求。

CLI

每种工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/meetrecord list_meetings '{"q":"budget","limit":5}'
npx @reneturcios/meetrecord get_transcript '{"meeting_id":"m123","format":"srt"}'
npx @reneturcios/meetrecord start_recording '{"title":"Weekly sync"}'
npx @reneturcios/meetrecord --version

输出是应用返回的响应正文。退出码： 成功时为 0，运行时错误（包括应用未运行等工具错误）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/meetrecord mcp

MCP 客户端配置：

{
  "mcpServers": {
    "meetrecord": {
      "command": "npx",
      "args": ["-y", "@reneturcios/meetrecord", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/meetrecord
docker run --rm ghcr.io/cloudcorprecords/meetrecord list_meetings '{}'

请注意，容器本身是一台独立的机器：如果以这种方式运行，请将 RECORDIST_API_URL 指向容器可访问的 Recordist 应用地址。

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake file reader + fake clock, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios