Barevalue

Barevalue MCP サーバー

Barevalue はポッドキャストの音声を編集します。エージェントに未編集の録音を渡すと、ノイズと音量を調整し、フィラー語や無音部分を取り除いた完成版のエピソードが返ってきます。長いエピソードの場合は、文字起こし、番組ノート、ハイライトクリップも作成します。

登録は1回の呼び出しで完了し、サインインは不要です。月に10時間まで無料で編集でき、最大320 kbpsまたはロスレスで納品されます。支払い情報は不要で、エージェントが編集ソフトを操作することもありません。

https://barevalue.com/mcp

インストール不要のストリーミング可能なHTTPで、接続にキーは必要ありません。エージェントがメールアドレスを使って barevalue_register を呼び出すと、その1回の呼び出しでキーを取得できます。

インストール

クライアント	1行で設定
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 を貼り付けます
スキルを読み込めるエージェント	npx skills add barevalue-ai/barevalue-mcp
ローカルディスク上のファイル	claude mcp add barevalue -- npx -y barevalue-mcp（下記の npm ブリッジ）

同じサーバーに接続するアドレスは2つあります。https://barevalue.com/mcp はオープンで、エージェント自身が登録してキーを保持します。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 にあるスキルを追加します。このスキルでは、エージェントに呼び出しの順序や、呼び出しが拒否された場合の対応を説明しています。このリポジトリは Cursor プラグイン（.cursor-plugin/plugin.json）でもあります。

Cursor では、インストールリンクも使用できます：cursor://anysphere.cursor-deeplink/mcp/install?name=barevalue&config=eyJ1cmwiOiJodHRwczovL2JhcmV2YWx1ZS5jb20vbWNwIn0=

ローカルマシン上の録音に使う npm ブリッジ

ホスト型サーバーに録音を渡すには、リンクを使います。ディスク上のファイルの場合、エージェントが実行する curl コマンドが返されます。npm パッケージ barevalue-mcp を使うと、この手順を自動で行えます。barevalue_upload にパスを渡すと、ファイルが送信されます。

用意するもの	使用するもの
すでにリンクがある録音	ホスト型サーバー https://barevalue.com/mcp
このマシン上の録音（Claude Code、Cursor、その他のローカルエージェント）	どちらも使用できます。このパッケージを使えば、エージェントが実行するコマンドはありません

このパッケージはホスト型サーバーへのブリッジです。ツールはサービスから取得され（クライアントがツール一覧を要求したときに取得され、5分間保持されます）、常に最新のものが使われます。

Claude Code：

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

または、任意の MCP クライアントの設定で使用できます：

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

Node 18 以降が必要です。

API キー

メールアドレスで Barevalue アカウントをまだ作成していない場合、利用開始にアカウントは不要です。エージェントがそのアドレスを使って barevalue_register を呼び出すと、その1回の呼び出しでキーを取得し、このサーバーがセッション終了まで保持します。リンクが記載されたメールが届きます。リンクをクリックするまでは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」です。冒頭のスポンサー読み上げを削除してください。

エージェントは次の操作を行います。

1. ファイルをアップロードします（barevalue_upload）
2. 編集を依頼します（barevalue_submit_url）
3. 完了するまで1分おき程度に状況を確認します（barevalue_status）。通常は5～15分かかります
4. ダウンロードリンクと、番組ノートおよび文字起こしのテキストを提示します（barevalue_content）
5. 仕上がりに満足したかを尋ねて、その旨を伝えます（barevalue_feedback）。または、メモを添えて再編集を依頼します（barevalue_request_revision）

ツール

一覧はサービスから取得されるため、tools/list が正式な情報源です。現在の一覧は次のとおりです。

ツール	内容
barevalue_register	1回の呼び出しでアカウントを作成し、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	プランと現在の処理時間を確認します

制限事項

• 音声のみです。1件の依頼につきファイルは1つで、音声トラックは1つ、長さは最大60分、サイズは最大750 MBです
• MP3、WAV、M4A、FLAC、AAC、OGG、Opus、WMA、AIFF に対応しています
• 無料プランでは、一度に編集できる依頼は1件までで、5時間以内の合計は120分までです
• アップロードしたファイルを依頼に使用できるのは1回のみで、アップロードから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（空の引用符、2 重になった引用符、閉じていない引用符）が設定されていると、起動時にサーバーが停止し、設定方法を示すメッセージを 1 行表示します。以前は、最初のケースではキーなしで起動し、ほかのケースでは呼び出しのたびに 401 が返されていました
• サービスが BAREVALUE_API_KEY のキー（失効、期限切れ、入力ミス）を拒否した場合、拒否されたことと、使用可能なキーを設定するか変数を削除して再起動するよう案内するようになりました。引き続き使用されるキーはこのキーのみです。セッションが barevalue_register から取得し、その後拒否されたキーは破棄されます。そのため、使用可能なキーを api_key として渡せます（同じアドレスを再登録しようとしても、その時点でアカウントが作成済みのため拒否されます）
• barevalue_upload はファイルを Barevalue 独自のストレージホストにのみ送信します。それ以外のアップロード先は、データを 1 バイトも送る前に拒否されます
• 時間のかかるアップロードでは、クライアントが進捗通知を求めている場合（呼び出しに進捗トークンがある場合）、およそ 1 秒ごとに進捗を通知します
• 呼び出しをキャンセルするとアップロードが停止し、クライアントが切断された場合も停止します。同じファイルが再度要求された場合は、割り当て済みのアップロードを再利用するため、再試行でアカウントの未注文アップロード枠を消費しません
• アップロード中のファイルに対して 2 回目の barevalue_upload が呼び出されると、ファイルを二重に送信せず、既存のアップロードに合流して同じ upload_id を返します
• サービスからのストリーミング応答に別のメッセージが含まれている場合や、応答後も接続が開いたままの場合に、応答を正しく読み取ります
• barevalue_upload はファイルを一度だけ開いて確認した内容を送信するため、その後に差し替えられたファイルは送信されません。ディスク上で複数の名前を持つファイル（ハードリンク）は拒否されます。その場合はコピーを作成して、そのコピーをアップロードしてください。プログラムに読み取り権限がないファイルは、わかりやすいメッセージとともに拒否されます

1.4.2 の変更点

• ストレージが応答の先頭部分を送信してから接続を切断した場合に、アップロードがいつまでも待機しなくなりました。呼び出しには理由が返され、ファイルが閉じられます。同じファイルが再度要求された場合は、割り当て済みのアップロードが使用されます。120 秒間応答がないアップロードも同様に停止します。ファイル全体の送信前にストレージから届いた成功応答は、アップロード成功とは見なされなくなりました
• barevalue_submit_url は冪等性キーを送信します。タイムアウトや接続障害などで応答が得られなかった注文を、30 分以内に同じ引数で再度要求すると、同じキーで送信されるため、二重に注文されません。タイムアウトメッセージにもその旨が表示されます。以前の注文に対する応答が返された場合は、その注文であることと、その後の状況が表示されます。注文が失敗した場合、同じ呼び出しをもう一度行うと新しい注文が作成されます。編集中または完了済みの場合は、同じ呼び出しでその注文が引き続き返されます。同じ録音に対して 2 つ目の注文を行う場合は、独自の 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 プラグインに対応し、スキルに 2 つ目のアドレス 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 ドキュメントをご覧ください。API ドキュメントは https://barevalue.com/llms-full.txt にプレーンな Markdown 形式でも掲載されています。

ライセンス

MIT