Barevalue

Barevalue MCP 服务

Barevalue 用于编辑播客音频。你的 Agent 提交原始录音后，就能获得制作完成的节目：降噪并调整音量，去除语气词和静音片段；较长的节目还会附带文字稿、节目简介和精彩片段。

调用一次即可注册，无需登录；每月可免费编辑 10 小时，输出码率最高可达 320 kbps，也可选择无损格式。无需提供付款信息，Agent 也不需要操作编辑器。

https://barevalue.com/mcp

使用 Streamable HTTP，无需安装，无需密钥即可连接。Agent 只需调用一次 barevalue_register 并提供你的电子邮箱地址，即可获取密钥。

安装

客户端	一行命令
Claude Code	claude mcp add --transport http barevalue https://barevalue.com/mcp
Claude Code，附带技能	/plugin install barevalue --marketplace barevalue-ai/barevalue-mcp
Claude（网页端和桌面端）	进入 Settings、Connectors、Add custom connector，然后粘贴 https://barevalue.com/mcp/connect
Cursor	在 ~/.cursor/mcp.json 的 mcpServers 下添加 "barevalue": { "url": "https://barevalue.com/mcp" }
ChatGPT	开启开发者模式后，添加连接器并粘贴 https://barevalue.com/mcp/connect
可读取技能的任何 Agent	npx skills add barevalue-ai/barevalue-mcp
本地磁盘上的文件	claude mcp add barevalue -- npx -y barevalue-mcp（下文介绍的 npm 桥接程序）

同一服务有两个地址。https://barevalue.com/mcp 是开放地址：Agent 自行注册并持有自己的密钥。https://barevalue.com/mcp/connect 会先要求你在浏览器中登录 Barevalue 账户，这是 Claude 和 ChatGPT 连接器页面所需的方式。

Claude Code 插件命令要求 Claude Code 版本为 2.1.275 或更高。若版本较早，请运行 claude plugin marketplace add barevalue-ai/barevalue-mcp，然后运行 claude plugin install barevalue@barevalue。该插件会添加托管服务，以及 skills/barevalue-podcast-editing 中的技能；该技能会指导 Agent 按顺序调用工具，并说明遇到拒绝时该如何处理。本仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json）。

Cursor 也支持安装链接：cursor://anysphere.cursor-deeplink/mcp/install?name=barevalue&config=eyJ1cmwiOiJodHRwczovL2JhcmV2YWx1ZS5jb20vbWNwIn0=

npm 桥接程序：处理本地录音

托管服务通过链接接收录音。对于磁盘上的文件，它会返回一条供 Agent 运行的 curl 命令。npm 包 barevalue-mcp 会自行完成这一步：barevalue_upload 接收文件路径并发送文件。

你的情况	使用方式
录音已有链接	托管服务，https://barevalue.com/mcp
录音在这台机器上（Claude Code、Cursor 或任何本地 Agent）	两者皆可。使用此软件包时，Agent 无需运行任何命令

该软件包是连接托管服务的桥接程序。它提供的工具来自服务端（客户端列出工具时会获取，缓存五分钟），因此始终是最新的。

Claude Code：

claude mcp add barevalue -- npx -y barevalue-mcp

或者，在任何 MCP 客户端的配置中：

{
  "mcpServers": {
    "barevalue": {
      "command": "npx",
      "args": ["-y", "barevalue-mcp"]
    }
  }
}

Node 18 或更高版本。

API 密钥

如果你的电子邮箱地址尚未关联 Barevalue 账户，无需先创建账户即可开始使用。Agent 只需调用一次 barevalue_register 并提供该地址，即可获取密钥；本服务会在本次会话的剩余时间内保存该密钥。你会收到一封包含链接的邮件：点击链接前，账户可编辑 30 分钟；点击后，每月可编辑 10 小时。

如果该地址已经关联账户，barevalue_register 会被拒绝，你需要自行创建密钥（前往 barevalue.com 的 Settings、API Keys）。设置密钥后，工具就不会再向你索取：

"env": { "BAREVALUE_API_KEY": "bv_sk_your_key_here" }

使用说明

使用 Barevalue 编辑 ~/recordings/ep42.wav 中的播客节目。这档节目名为“Tech Talk”，本期名称为“AI in 2026”。请删除开头的赞助商口播。

Agent 将会：

1. 上传文件（barevalue_upload）
2. 下单进行编辑（barevalue_submit_url）
3. 每分钟左右检查一次进度，直到完成（barevalue_status），通常需要 5 到 15 分钟
4. 提供下载链接，以及文本格式的节目说明和转录稿（barevalue_content）
5. 询问你是否满意，并转达反馈（barevalue_feedback）；或者根据你的备注再次编辑（barevalue_request_revision）

工具

列表来自服务，因此以 tools/list 为准。目前：

工具	功能
barevalue_register	一次调用即可创建账户并获取 API 密钥
barevalue_upload	从这台机器上传音频文件
barevalue_submit_url	下单进行编辑，可编辑已上传文件或链接中的音频
barevalue_status	查看进度、剩余时间、下载链接，以及编辑内容
barevalue_content	以文本形式显示节目说明、转录稿和编辑摘要
barevalue_feedback	反馈编辑效果是否满意
barevalue_request_revision	根据新说明再次编辑已完成的订单
barevalue_updates	查看自上次调用以来账户中的所有新增内容
barevalue_list_orders	查看近期订单
barevalue_account	查看本月剩余分钟数和速率限制
barevalue_estimate	估算指定时长的订单是否会被接受
barevalue_validate	预先检查链接中的音频
barevalue_pricing、barevalue_api_status	查看套餐和当前处理时间

限制

• 仅支持音频。每个订单只能有一个文件，且只能包含一个音轨，时长上限为 60 分钟，文件大小上限为 750 MB
• 支持 MP3、WAV、M4A、FLAC、AAC、OGG、Opus、WMA 和 AIFF
• 免费套餐一次只能编辑一个订单，且每 5 小时最多处理 120 分钟
• 上传的文件必须在上传后 2 小时内下单，且每个文件只能下单一次

1.4.0 版变更

• 工具现在来自托管服务。barevalue_submit（带有 order_id）、Webhook 工具和人工编辑功能已移除：服务已停用这些功能
• barevalue_upload 使用新的上传流程，并返回供 barevalue_submit_url 使用的 upload_id
• BAREVALUE_API_KEY 为可选项
• 不再读取 BAREVALUE_API_URL
• 设置 BAREVALUE_API_KEY 后，只会使用该密钥：传给工具的 api_key 会被忽略，barevalue_register 也不会替换它
• barevalue_upload 仅发送音频文件（根据实际文件扩展名判断），且不会跟随重定向

1.4.1 版本变更

• 如果 BAREVALUE_API_KEY 不是有效的密钥（空引号、两层引号、未闭合的引号），服务器会在启动时停止，并用一行说明如何设置。之前，第一种情况会在没有密钥的情况下运行，其他情况则会导致每次调用都收到 401
• 当服务拒绝 BAREVALUE_API_KEY 中的密钥（已撤销、已过期或拼写错误）时，现在会说明原因以及该怎么做：设置可用的密钥或移除该变量，然后重启。该密钥仍然是唯一会使用的密钥。会话从 barevalue_register 获取的密钥之后若被拒绝，则会被丢弃；此时可以将可用密钥作为 api_key 传入（同一地址不能再次注册，因为它此时已经拥有账户）
• barevalue_upload 只会将文件发送到 Barevalue 自有的存储主机。其他任何上传地址都会在发送任何字节前被拒绝
• 如果客户端请求进度（在调用中提供进度令牌），长时间上传大约每秒会报告一次进度
• 取消调用会停止上传；客户端断开连接也会停止上传。再次请求同一文件时，会复用之前分配给它的上传，因此重试不会消耗账户的无序上传额度
• 如果文件仍在上传，第二次调用 barevalue_upload 会加入该上传并返回相同的 upload_id，而不是再次发送文件
• 即使服务返回的流式响应中包含其他消息，或在响应后仍保持打开状态，也能正确读取
• barevalue_upload 只会打开文件一次，并发送经过检查的内容，因此之后替换的文件不会被发送。磁盘上有多个名称的文件（硬链接）会被拒绝：请复制该文件并上传副本。如果程序无法读取文件，会用直白的文字说明

1.4.2 版本变更

• 如果存储端发送了响应的开头后就断开连接，上传不再会无限期等待。调用会返回原因，文件会被关闭，再次请求同一文件时会复用之前分配给它的上传。静默 120 秒的上传也会以相同方式停止。在整个文件发送完成前收到的存储端确认，不再会被视为上传成功
• barevalue_submit_url 会发送幂等键。如果某个订单未收到答复（超时或连接中断），并在 30 分钟内使用相同参数再次请求，则会使用相同的键发送，因此不会重复下单。超时消息会说明这一点。如果答复对应的是之前的订单，则会说明这一点以及订单的处理结果。如果订单失败，再次进行相同调用会下一个新订单。如果订单正在编辑或已完成，相同调用会继续返回该订单；同一录音的第二个订单则需要使用你自己的 idempotency_key。你自行传入的 idempotency_key 会按原样发送
• 当会话没有密钥时，barevalue_upload 会像其他工具一样列出 api_key。它一直都需要该参数
• 关于 barevalue_register 的说明不再承诺向已拥有账户的地址提供密钥：该调用会被拒绝，密钥可在 Settings、API Keys 中获取

1.4.3 版本变更

• 程序与 1.4.2 版本相同。在服务端，超过 60 分钟的文件现在会在任何编辑开始前被拒绝，且不会占用额度。之前，这类文件可能会被接受，但在处理过程中失败
• 软件包现在注明了其仓库 barevalue-ai/barevalue-mcp，本页面也优先介绍托管服务及如何将其添加到各个客户端
• 该仓库是 Claude Code 插件和 Cursor 插件，技能中注明了第二个地址 https://barevalue.com/mcp/connect

开发

npm install
npm run build
node test-mcp.js                                   # live read-only smoke test, then the local tests; no key needed
node test-mcp.js --offline                         # the local tests only, against a stub inside the test
BAREVALUE_API_KEY=... node test-mcp.js episode.mp3 # also uploads the file, places no order

支持

[email protected]、开发者页面或 API 文档，文档也提供纯 Markdown 版本，地址为 https://barevalue.com/llms-full.txt。

许可证

MIT