Transcripted

Transcripted MCP

用于 Transcripted 会议、听写和写作的只读本地工具。

对于 Claude Desktop 用户，最好在应用内完成设置：

1. 打开 Transcripted。
2. 打开“设置”。
3. 转到 Agent。
4. 点击 Install in Claude。
5. 重启 Claude Desktop。

此方式会安装随附的辅助程序、更新 Claude Desktop 的配置，并运行本地自检。

交互式 UI（MCP Apps）

该服务通过 MCP Apps 扩展（io.modelcontextprotocol/ui，SEP-1865）提供一个交互式小组件：调用 show_recent_meetings 可呈现近期会议的卡片列表——每条会议都支持内嵌音频播放和原始转录文本查看——并显示在支持渲染的客户端中。它完全自包含（无需网络；本地音频和转录文本通过本地传输），在不渲染内嵌 UI 的客户端（例如 Claude Code CLI）中则会回退为纯文本列表。目前可在 ChatGPT、VS Code、Cursor 和 Goose 中内嵌呈现；请参阅 docs/mcp-ui-recent-meetings.md，了解各客户端支持情况以及试用方法。

源码构建

仅在直接开发 MCP 服务时使用：

swift build -c release
swift test

二进制文件：

.build/release/transcripted-mcp

自检：

.build/release/transcripted-mcp --self-test

当 Transcripted 已写入本地目录清单或 transcriptSaveLocation 偏好设置时，服务会优先读取应用所选的录制库。 未设置自定义录制库时，服务会读取：

~/Library/Application Support/Transcripted/captures/meetings
~/Library/Application Support/Transcripted/captures/dictations
~/Library/Application Support/Transcripted/captures/writing

可使用 TRANSCRIPTED_DATA_DIR、TRANSCRIPTED_MEETINGS_DIR、 TRANSCRIPTED_DICTATIONS_DIR、TRANSCRIPTED_WRITING_DIR 或 TRANSCRIPTED_INDEX_DIR 覆盖路径。 如果 TRANSCRIPTED_DATA_DIR 指向包含 meetings/、 dictations/ 或 writing/ 子文件夹的共享根目录，transcripted-mcp 会自动使用这些 子文件夹，并将其 SQLite 索引存储在该共享根目录中，除非同时设置了 TRANSCRIPTED_INDEX_DIR。如果按类型覆盖会议或听写目录，只有在同时设置 TRANSCRIPTED_WRITING_DIR 时才会读取写作内容。

写作

list_writing 和 read_writing 与 list_dictations 和 read_dictation 类似，用于处理 Writing_<date>.md 日期文件（即用户使用 Transcripted 键盘输入的内容）。search_context 和 recent_context 接受 kind: "writing"，而 all 也会包含写作内容。写作搜索仅支持全文搜索；设备端嵌入向量仅涵盖会议和听写内容。

遥测

每次受跟踪的录制内容查询完成后，服务都可以发送一个匿名 PostHog 事件 （agent_capture_query_observed，参见 AgentCaptureQueryTelemetry.swift）。result 的值为 success、 empty_not_found、invalid_input 或 internal_error。载荷仅包含粗粒度且经允许名单筛选的元数据：客户端、工具和录制类型；延迟以及来源数量和结果数量区间；结果；以及在可用时，所属应用经过验证的 app_version、构建渠道和修订版本。如果应用未安装构建身份信息，则会省略该信息；绝不会使用辅助程序自身的服务版本作为应用版本的备用值。source_count_bucket 表示对响应有贡献的不同录制文件数量。result_count_bucket 表示该工具自然响应粒度下返回的记录数量。转录文本、查询字符串、录制 ID、标题、名称、文件路径、音频和用户标识符绝不会作为属性发送。

此功能经过双重门控：

• 遵循应用的匿名分析开关 （observability-anonymous-analytics-enabled；关闭时不会发送任何内容）
• 除非通过 POSTHOG_API_KEY/POSTHOG_HOST、本地覆盖项或应用包中的 TranscriptedPostHogAPIKey 配置了 PostHog API 密钥和 HTTPS 主机，否则完全不执行；默认情况下，源码构建不会配置这些内容

在任何模式下，转录文本和音频都不会离开这台 Mac。

跨会议回执工具

WS2.3 为 Agent 添加了本地结构化检索工具：

• decisions(topic, range)
• commitments(person, range)
• open_questions(project, range)
• search_meetings(query, range)

每个工具都返回 JSON 回执，包含 meetingId、timestamp 和 quote。 在有精确音频锚点之前，从摘要生成的回执中 timestamp 为 null；原始话语搜索会包含转录时间戳。这些工具仅使用本地 SQLite 索引和已保存的摘要／解析器输出。

MCP Bundle 和 Registry

每个版本也可以将此辅助工具打包为 MCP Bundle （transcripted-mcp.mcpb），供直接安装 Bundle 的客户端使用，并将其列入官方 MCP Registry，名称为 io.github.r3dbars/transcripted。

Publish MCP Bundle 工作流会完成这两项操作。它会从发布 DMG 中复制已签名的辅助工具，使用 mcpb/manifest.json 将其打包，将 Bundle 附加到发布版本，然后填写并发布根目录下的 server.json。发布版本时会运行此工作流。它不支持手动触发（因为可以从任何分支运行）；要重试，请重新运行该任务。 它不会重新构建任何内容，因此 Bundle 会保留已公证应用的签名。

仓库根目录下的 glama.json 声明维护者拥有 Glama 列表的所有权。