narrador

narrador MCP サーバー

narrador は、ドキュメントや X（Twitter）の投稿を、単語単位のタイムスタンプ付きの自然なナレーション音声に変換します。PDF、Word、EPUB、テキストをアップロードして音声を選択するか、narrador files にドキュメントの言語に応じた音声を選ばせて、変換ジョブを開始できます。ステータスを確認し、タイミングが同期された音声をダウンロードできます。narrador X も同様に、投稿を音声に変換します。narrador.io で OAuth を使ってサインインするか、製品 API キーを使用してください。

narrador 用のリモート Model Context Protocol サーバーです。AI エージェント（Claude、Cursor、VS Code、Windsurf、ChatGPT、および任意の MCP クライアント）が narrador files と narrador X を利用できます。

• narrador files：PDF、Word、EPUB、その他のドキュメント → 単語単位のタイミング付き音声。
• narrador X：X/Twitter の投稿 → 音声。

エンドポイント	https://api.narrador.io/mcp（Streamable HTTP）
認証	OAuth 2.1（推奨）または API キー
REST API ドキュメント	https://api.narrador.io/docs
OpenAPI	https://api.narrador.io/openapi.json
Web サイト	https://narrador.io

リポジトリ：https://github.com/narrador-io/narrador-mcp

このリポジトリには、公開リスティング（server.json）、レジストリのメタデータ（glama.json）、ドキュメントのみが含まれています。サーバーは narrador がホストしているため、ローカルにインストールするものはありません。

クレジット

利用料金は narrador クレジットで計算されます（get_account を参照）。ジョブと生成では、実行時にクレジットを消費します。サブスクリプションはありません。narrador の Web アプリでクレジットを購入し、クレジットを消費するツールを呼び出す前に残高を確認してください。

ツール（7）

ツール	製品	機能
get_account	両方	ユーザー情報、製品の対象範囲、narrador クレジット残高（読み取り専用）
list_voices	両方	narrador files または narrador X の音声
create_files_job	narrador files	ドキュメント → 音声のジョブを開始
get_files_job	narrador files	ジョブのステータスと進行状況を確認
get_files_result	narrador files	完了したジョブの音声と単語単位のタイミングをダウンロード
generate_x_audio	narrador X	X の投稿の音声を生成
get_x_generation	narrador X	以前に作成した生成結果を取得

get_account

パラメーターはありません。user、app（API キーの製品、または OAuth の場合は null）、products（files および／または x）、credits（totalAvailable とバケットごとの balances）を返します。クレジットは消費しません。

list_voices

パラメーター	必須	説明
product	いいえ	一覧表示するカタログ（files または x）。デフォルトは API キーの製品です。両方の製品を利用できる OAuth トークンの場合は、files がデフォルトです。

各音声には id、name、tier（standard または cheaper）、defaultAccent、isPublic、description、sampleUrl（https://api.narrador.io/v1/voices/{id}/sample。API キー不要のニュートラルなサンプルへリダイレクトします）が含まれます。レガシーの provider フィールドは tier と同じ値を示す場合がありますが、非推奨です。tier を使用してください。

create_files_job

text と fileId のいずれか一方を指定してください。両方は指定できません。

パラメーター	必須	説明
text	text または fileId のいずれか	プレーンテキスト（1～500,000 文字）。fileName は任意です（デフォルトは document.txt）。
fileId	text または fileId のいずれか	アップロード済みファイルの UUID。fileName が必須です。
fileName	fileId を指定する場合	ジョブのファイル名（1～200 文字）。
voiceId	いいえ	list_voices の音声 UUID。accent と一緒に指定するか、両方とも省略してください。
accent	いいえ	アクセントコード（例：en-us、es-es、pt-br）。voiceId と一緒に指定するか、両方とも省略してください。

voiceId と accent を省略すると、narrador はドキュメントから言語（en-us、es-es、pt-br）を検出します。テキストが非常に短い場合や言語を検出できない場合は、en-us にフォールバックします。その後、該当言語の標準ティアの音声を選択し、該当する音声がない場合は低価格ティアの音声を選択します。選択順はカタログの順序に基づき、常に一定です。検出された言語に対応する音声がない場合、ジョブは failed_file_processing で終了します。その場合は、voiceId と accent を明示的に指定してください。

jobId が返されます。get_files_job で状態を確認し、ステータスが completed になったら get_files_result を呼び出してください。クレジットを消費します。

get_files_job

パラメーター	必須	説明
jobId	はい	create_files_job から取得した UUID。

ステータス（例：processing、completed、failed）、progressPercentage、および準備ができた場合は audioId が返されます。

get_files_result

パラメーター	必須	説明
jobId	はい	完了したジョブの UUID。

audioUrl、audioId、duration、および wordTimings（word、startTime、endTime）が返されます。

generate_x_audio

パラメーター	必須	説明
voiceId	はい	list_voices の音声 UUID（product: x）。
accent	いいえ	アクセントコード。デフォルトは en-us です。
postId	postId または postUrl のいずれか	数値形式の X 投稿 ID。
postUrl	postId または postUrl のいずれか	X 投稿の完全な URL。

準備ができると（多くの場合、すぐに）、generationId、audioUrl、duration、および wordTimings が返されます。必要に応じて get_x_generation で状態を確認してください。クレジットを消費します。

get_x_generation

パラメーター	必須	説明
generationId	はい	generate_x_audio から取得した UUID。

generate_x_audio が正常に完了した場合と同じ音声メタデータが返されます。アカウントに紐付いた生成結果のみが返されます。それ以外の ID を指定すると、生成結果が見つからないという応答が返されます。

認証

OAuth（推奨）。 URL https://api.narrador.io/mcp をクライアントに追加してください。クライアントが認可サーバー（https://narrador.io/api/auth）を検出します。narrador.io にサインインして、アクセスを承認してください。スコープ：narrador:files、narrador:x。

API キー。 narrador のウェブアプリでキーを作成し、Authorization: Bearer <key> または x-api-key: <key> として送信してください。キーは製品ごとにスコープが設定されています。

製品	プレフィックス
narrador files	nrd_files_
narrador X	nrd_x_

接続

Claude Desktop

Settings → Connectors → Add custom connector → URL https://api.narrador.io/mcp → Connect の順に進み、narrador.io で OAuth を完了してください。

Cursor

プロジェクト（.cursor/mcp.json）またはユーザー（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "narrador": { "url": "https://api.narrador.io/mcp" }
  }
}

API キーを使用する場合：

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp",
      "headers": { "Authorization": "Bearer nrd_files_..." }
    }
  }
}

VS Code

.vscode/mcp.json：

{
  "servers": {
    "narrador": { "type": "http", "url": "https://api.narrador.io/mcp" }
  }
}

Claude（claude.ai）

Claude Desktop と同様に、https://api.narrador.io/mcp を指定して Add custom connector を選択してください。

Claude Code

claude mcp add --transport http narrador https://api.narrador.io/mcp

Windsurf（~/.codeium/windsurf/mcp_config.json）

{
  "mcpServers": {
    "narrador": { "serverUrl": "https://api.narrador.io/mcp" }
  }
}

その他のクライアント

https://api.narrador.io/mcp（Streamable HTTP）を指定してください。クライアントが OAuth に対応していない場合は、Authorization ヘッダーに API キーを指定してください。

プロンプトの例

• 「narrador のクレジットを確認してから、この PDF を narrador files で音声に変換してください。」
• 「narrador files のスペイン語の標準ティア音声を一覧表示してから、このテキストのジョブを作成してください。」
• 「この X 投稿を narrador X で音声にしてください：https://x.com/…/status/…」

ライセンス

MIT。詳細は LICENSE を参照してください。