Woodstitch

woodstitch-mcp

Woodstitch API 用の MCP サーバーです。 有償の人間のリスナーが、ブラインドテストでテキスト読み上げ音声を評価し、 エージェントは信頼区間付きの数値を受け取ります。

タスクは2種類のみです。ペア比較（リスナーが同じテキストの音声クリップを2つ聞き、強制選択でどちらかを選ぶ）と、人間かAIかの検出（音声クリップ1つを聞き、人間またはAIの確信度を1～4で評価）です。MOS、CMOS、MUSHRA、または1～5の尺度には対応していません。

インストール

https://woodstitch.com/app/api-keys でAPIキーを取得してから、次を実行します。

Claude Code

claude mcp add woodstitch -e WOODSTITCH_API_KEY=ws_live_... -- uvx woodstitch-mcp

Claude Desktop / Cursor / 任意のMCPクライアント（mcpServers エントリ）：

{
  "woodstitch": {
    "command": "uvx",
    "args": ["woodstitch-mcp"],
    "env": {"WOODSTITCH_API_KEY": "ws_live_..."}
  }
}

pipx run woodstitch-mcp または pip install woodstitch-mcp && woodstitch-mcp でも動作します。 Python 3.10以降が必要です。

Claude Code ユーザー向け： Woodstitch plugin には、このサーバーと、リスニングテストをいつ、どのように実行するかを理解するスキルが含まれています。 /plugin marketplace add woodstitch-llc/claude-plugin を実行してから、/plugin install tts-human-eval@woodstitch を実行してください。

ツール

ツール	機能	費用
woodstitch_templates	測定する項目と測定しない項目（APIキー不要）	–
woodstitch_pricing	料金表と計算例（APIキー不要）	–
woodstitch_account	残高と利用額	–
woodstitch_upload_files	ローカルの音声をアップロードして、ファイルIDを取得	–
woodstitch_create_eval	テストを作成して料金を見積もります。料金の見積もりのみには dry_run を指定します	課金なし
woodstitch_start_eval	テストを開始します	料金が発生
woodstitch_get_eval	進捗と暫定スコア	–
woodstitch_get_results	最終的な数値	–
woodstitch_export	すべての評価を行単位で出力します（jsonまたはcsv。ファイルへの出力も可能）	–
woodstitch_cancel_eval	テストを早期終了し、実施済みの作業分のみ支払います	–
woodstitch_list_evals、woodstitch_list_files、woodstitch_delete_file	管理	–

組み込みの安全対策

• woodstitch_start_eval には user_confirmed_amount_usd が必須です。これはユーザーが同意した見積もり合計額であり、厳格な上限額 max_total_usd としてAPIに送信されます。見積もり額がユーザーの確認額を超えている場合、APIは拒否し（over_max）、テストは開始されません。エージェントが、ユーザーが料金を確認していないテストを開始することはできません。
• すべてのPOSTリクエストには Idempotency-Key が付与されるため、リトライしてもテストが重複して作成または開始されることはありません。
• サーバーの指示では、モデルに対し、途中経過の数値は暫定的なものであり、しきい値に達した時点で早期終了することは任意の停止にあたると伝えます。

一般的なセッション

1. woodstitch_upload_files(["a/001.wav", "b/001.wav", ...]) を使うか、公開URLを使用します。
2. woodstitch_create_eval(pairs=[{"id":"001","a":"file_…","b":"file_…","passage":"001","system_a":"base","system_b":"candidate"}, …], ratings_per_pair=5) → 見積もりが返されます。課金はありません。
3. 合計額をユーザーに提示します。承認されたら、woodstitch_start_eval(eval_id, user_confirmed_amount_usd=<total>) を実行します。
4. ときどき woodstitch_get_eval(eval_id) を実行します。通常、最初の評価は数分以内に届きます。
5. status が completed になったら woodstitch_get_results(eval_id) を実行します。行単位のデータには woodstitch_export を使用します。

手法、リスナーへの報酬、各種制御については、https://woodstitch.com/research/methodology をご覧ください。 機械可読なAPI仕様：https://woodstitch.com/openapi.json。

開発

uv venv && . .venv/bin/activate && uv pip install -e .
WOODSTITCH_API_KEY=ws_live_... woodstitch-mcp        # stdio server

MIT © Woodstitch LLC