Pepys

pepys-mcp

Pepys による、AI エージェント向けの文字起こしサービスです。

Pepys 文字起こし MCP サーバーは、MCP に対応するあらゆるエージェント（Claude、ChatGPT、Cursor、Gemini、オープンソースのエージェント）に、話者ラベルとタイムスタンプ付きの音声・動画の文字起こしを提供します。話者ダイアライゼーション、SRT/VTT 字幕、リンクを貼り付けての取り込み（YouTube、ポッドキャスト、Drive/Dropbox）、一括処理、単語レベルのエクスポートに対応しています。Pepys が音声をトレーニングに使用することはありません。

このパッケージは Pepys API キーを使い、stdio 経由でローカル実行されます。また、Pepys は互換性のあるリモート MCP クライアント向けに、本番環境用 OAuth コネクター https://pepys.co/api/mcp もホストしています。

インストールと設定

Node ≥ 18 と、https://pepys.co/developers から取得した Pepys API キー（pk_live_…）が必要です。一部の機能にはアカウントの利用資格が必要です。

グローバルインストールせずに npx で実行します。

Claude Desktop / Claude Code – claude_desktop_config.json（または claude mcp add）：

{
  "mcpServers": {
    "pepys": {
      "command": "npx",
      "args": ["-y", "pepys-mcp"],
      "env": { "PEPYS_API_KEY": "pk_live_your_key_here" }
    }
  }
}

Cursor – ~/.cursor/mcp.json。形式は同じです。Windsurf / その他の開発エージェント – PEPYS_API_KEY を環境変数に設定し、npx -y pepys-mcp を指定します。

任意の環境変数：PEPYS_API_BASE（デフォルトは https://pepys.co/api/v1 です）。

Claude Code プラグイン

このリポジトリには、ホスト型 OAuth コネクターを指定する Claude Code プラグインも含まれています（API キーは不要です）。

/plugin marketplace add ankurmans/pepys-mcp
/plugin install pepys

最初のツール呼び出しで、Pepys アカウントへの OAuth サインインが開始されます。利用できる機能とプロンプトの例については、skills/pepys/SKILL.md を参照してください。

ツール

ツール	機能
transcribe	url（ファイル / YouTube / ポッドキャスト / Drive）または file_ref から文字起こしを開始します。オプション：diarize（利用資格が必要）、summary、chapters、translate_to、quality、ポッドキャストの episode_guid / episode_index。{ job_id, status } を返します。
get_transcription	job_id でジョブを取得します。短いクリップを 1 回の呼び出しで完了までロングポーリングするには、wait_ms:25000 を設定します。
upload_file	ローカルメディア（path または bytes_base64）をアップロードし、transcribe 用の file_ref を取得します。
list_transcriptions	最近のジョブ（ID、ステータス、タイトル、分数）を一覧表示します。
list_podcast_episodes	RSS/Apple/Spotify フィードのエピソードを、episode_guid とともに一覧表示します。
transcribe_podcast_feed	フィード全体（または最新の N 件）を一括処理します。アカウントの利用資格が必要です。
export_transcript	SRT / VTT / TXT / MD / JSON 形式でエクスポートします。単語レベルのタイミング情報にはアカウントの利用資格が必要です。（DOCX/PDF はウェブアプリを使用してください。）
search_transcript	長い文字起こしからフレーズを検索し、一致したタイムスタンプ付きセグメントのみを返します（文字起こし全体のコンテキストを読み込みません）。
ask_transcription	サーバーが検証した、引用元付きの主張のみで、文字起こしに関する質問に回答します。
get_credit_balance	残りの文字起こしクレジットと利用資格の状態を取得します。

また、完了した文字起こしをリソース pepys://transcription/{id} として公開し、transcribe_and_summarize プロンプトも提供します。

**MCP 経由でのアカウント制限：**残高不足の場合は 402 が返されます。利用できない機能の場合は、明確な利用資格の結果と、対応する代替手段があればそれが返されます。MCP サーバーが購入を開始したり、購入手続きのページへのリンクを表示したりすることはありません。

開発

npm install
npm run build      # tsc → dist/ (+ chmod the bin)
npm run smoke      # PEPYS_API_KEY=pk_live_… npm run smoke  – hits the live API to verify your key

公開

npm run build && npm publish（pepys-mcp を公開します）。レジストリへの掲載（MCP registry、mcp.so、Smithery、PulseMCP、Glama、awesome-mcp-servers）は個別に申請します。

概要

Pepys が開発しました。詳しくは pepys.co · MCP サーバー · 開発者向けドキュメント をご覧ください。

ライセンス

MIT