txscribe

@txscribe/mcp

一个面向 txscribe 开发者 API 的 MCP 服务。它让 AI 助手使用你的 txscribe 账户转录链接，并通过 https://txscribe.ai/developers 中记录的同一 API 读取转录文本和摘要。

有两种连接方式，使用相同的八种工具：

• 托管版 — https://txscribe.ai/mcp（Streamable HTTP）。Claude 和 ChatGPT 将其作为自定义连接器接入，并通过 OAuth 登录 txscribe；无需安装。支持设置请求头的客户端也可以改用 API 密钥。
• 本地版 — 此软件包由 Claude Desktop、Claude Code、Cursor 及其他可自行启动 MCP 服务的客户端作为命令运行（npx -y @txscribe/mcp），并在环境中配置你的 API 密钥。

两种方式都只是轻量封装：每种工具都会以你的身份调用一次开发者 API。工具能执行的操作以及消耗的分钟数，完全取决于你的账户在应用中的权限。不会缓存或在你的机器上存储任何内容。

托管版：Claude 和 ChatGPT

• Claude（claude.ai、桌面应用）：Settings → Connectors → Add custom connector，URL 填写 https://txscribe.ai/mcp。Claude 会打开 txscribe；登录并选择 Allow。
• ChatGPT（需开启开发者模式）：添加连接器，URL 填写 https://txscribe.ai/mcp，身份验证方式选择 OAuth，然后在打开的 txscribe 页面上允许连接。
• Claude Code：运行 claude mcp add --transport http txscribe https://txscribe.ai/mcp（通过 OAuth 登录），或使用密钥： claude mcp add --transport http txscribe https://txscribe.ai/mcp --header "Authorization: Bearer txs_live_…"。
• Cursor 和其他支持填写 URL 和请求头的客户端：使用上述 URL 和请求头 Authorization: Bearer txs_live_…。

通过 Allow 建立的连接会创建一个由应用为你保管的 API 密钥。此密钥列在 Plan and billing → Developer API 下；选择 Revoke 即可断开该应用的连接。密钥不会自行过期。

本地版：此软件包

1. 在应用中打开 Plan and billing → Developer API 并创建密钥（密钥以 txs_live_ 开头；创建时只会显示一次）。
2. 在客户端中添加此服务，并在其环境中配置密钥。

Claude Desktop（claude_desktop_config.json）或其他支持命令的客户端：

{
  "mcpServers": {
    "txscribe": {
      "command": "npx",
      "args": ["-y", "@txscribe/mcp"],
      "env": { "TXSCRIBE_API_KEY": "txs_live_…" }
    }
  }
}

Claude Code：

claude mcp add txscribe --env TXSCRIBE_API_KEY=txs_live_… -- npx -y @txscribe/mcp

TXSCRIBE_API_BASE 用于指定此服务要连接的其他部署（默认值为 https://txscribe.ai/api/v1）。

工具

工具	功能	是否会写入？
list_transcriptions	查看你的转录记录，按时间从新到旧排列，并支持分页	否
search_transcriptions	查找哪些录音说过某个词或短语，以及说到的时间：每条录音最多返回五个匹配项，并标出开始的秒数。会搜索你最近 500 条录音中已完成的转录内容；搜索的是说过的话，而非标题。	否
transcribe_link	根据链接创建转录（YouTube、Google Drive、Dropbox …）。录音只会被转录，绝不会下载。会消耗你的分钟数。	是
get_transcription	查看一条转录的状态和元数据	否
get_transcript	获取已完成的转录内容，格式为 json（片段、词语时间戳、说话人）、txt、srt 或 vtt；使用 from 和 to（秒）仅获取某个时间点附近的段落，使用 summaryOnly 获取摘要	否
get_summary	获取摘要及其状态	否
request_summary	请求生成摘要，或重新生成摘要，并指定语言和录音类型	是
delete_transcription	删除一条转录及其生成的所有内容。此操作无法撤销。	是，会造成不可逆更改

五个工具只读；三个工具会更改你的账户。上传文件不是工具：API 的上传方式是对整个文件执行签名 PUT，助手无法通过聊天完成此操作。请使用应用，或直接调用 API 来处理文件。

典型交互："转录这场演讲，并告诉我需要核实的三个观点" → transcribe_link → 持续调用 get_transcription，直到 status 为 done → get_transcript（txt）→ 助手读取转录内容；调用 request_summary + get_summary 获取 txscribe 生成的摘要。

在已有录音中查找内容："我们对预算达成了什么共识？" → search_transcriptions（"budget"）→ 对返回的匹配项调用 get_transcript，并用 from/to 指定其附近的内容，而不是获取完整转录。

错误

API 拒绝请求时会返回工具错误，其中包含 API 自身的错误代码（invalid_api_key、 quota_exceeded、not_ready、unsupported_link …）、HTTP 状态码、供你向支持团队引用的请求 ID，以及在 429 响应中提供的 Retry-After 秒数。服务端不会自行重试任何请求。

开发

npm ci
npm test

测试会通过内存传输层，使用伪造的 fetch 运行服务端；不会访问网络。托管服务端位于 Web 应用中（web/src/lib/mcp/），其测试会检查工具列表是否与此处一致。

发布（维护者）

cd mcp
npm ci && npm test
npm login                      # an npm account that owns the @txscribe scope
npm publish                    # publishConfig makes it public; prepublishOnly runs the tests

server.json 是 MCP Registry（registry.modelcontextprotocol.io）的入口；其中的 name 与 package.json 中的 mcpName 一致，Registry 会据此验证 npm 包属于我们。 等 npm 包发布并启用托管端点后，使用 mcp-publisher 和 txscribe.ai 的 DNS 证明发布。