TwelveLabs MCP Server

このプロジェクトはTwelveLabs（動画理解プラットフォーム）とは関係ありません。 これは**ElevenLabs Conversational AI API**のためのMCPサーバーです — 音声エージェント、ナレッジベース、会話、TTSを扱います。「TwelveLabs」という名前はプロジェクトのコードネームにすぎません。

拡張されたMCP（Model Context Protocol）サーバーで、互換性のあるMCPクライアントにElevenLabs Conversational AI APIへの直接アクセスを提供します。公式のElevenLabs MCPコネクタでは公開されていない機能も含みます。

対象機能

• エージェント — 一覧表示、完全な設定の取得（LLMモデルと温度を含む）、プロンプト/設定の更新、ウェブフックとファイルアップロードの管理

• ナレッジベース — 一覧表示、完全なコンテンツの読み取り、テキスト/URLドキュメントの追加、ドキュメントの削除

• 会話 — 履歴のフィルタリングとタグ付け、トランスクリプトの検査、通話後の分析/評価の再実行

• 音声 — 利用可能な音声の一覧表示と検索

Related MCP server: elevenlabs-mcp-experiments

前提条件

• Node.js >= 18

• ElevenLabs APIキー — elevenlabs.ioで取得できます。

クイックスタート

オプションA: npx（クローン不要）

ELEVENLABS_API_KEY=your-key npx twelvelabs-mcp-server

オプションB: クローンしてビルド

git clone https://github.com/micro-JAY/twelvelabs-mcp-server.git
cd twelvelabs-mcp-server
npm install --include=dev
npm run build

MCPクライアントに接続

MCPクライアントの設定に同等のサーバーエントリを追加してください。設定ファイルの場所や周囲の構文はクライアントによって異なります。以下は標準的なstdioサーバー定義です：

{
  "mcpServers": {
    "twelvelabs": {
      "command": "node",
      "args": ["/path/to/twelvelabs-mcp-server/dist/index.js"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

MCPクライアントを再起動または再接続してください。利用可能なツールリストにtwelvelabsが表示されるはずです。

使用方法

MCP対応アシスタントにツールの使用を依頼してください。例：

"エージェントを一覧表示" "agent_1001kjbh14xce5kbreh55ydf4raeの完全な設定を取得" "そのエージェントの直近10件の会話を表示" "conversation_xyzのトランスクリプトと分析を取得"

互換性

このサーバーは、stdioトランスポートをサポートし、ローカルサーバープロセスに環境変数を設定できるMCPクライアントで動作します。リモートHTTP MCPサーバーのみをサポートするクライアントは、互換性のあるstdioブリッジまたはプロキシが必要です。

ツールリファレンス

エージェントツール

ナレッジベースツール

会話ツール

音声ツール

セキュリティ

• 入力検証 — すべてのツールパラメータはAPIに到達する前にZodスキーマで検証されます

• HTTPSの強制 — ウェブフックURLはHTTPSのみを使用するように検証されます

• パストラバーサル保護 — ドキュメントとエージェントIDはパストラバーサルを防ぐためにサニタイズされます

• エラーのサニタイズ — 内部エラーは捕捉され、安全なMCPエラーレスポンスとして返されます。生のスタックトレースがクライアントに公開されることはありません

開発

npm run dev   # watch mode with tsx -- auto-reloads on file changes
npm run build # compile to dist/

コントリビューション

1. リポジトリをフォークする

2. フィーチャーブランチを作成する（git checkout -b feat/my-feature）

3. 変更をコミットする（git commit -m 'feat: add my feature'）

4. ブランチにプッシュする（git push origin feat/my-feature）

5. プルリクエストを開く

ライセンス

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

アーキテクチャノート

すべてのツールは、起動時にELEVENLABS_API_KEYから初期化される単一のAxiosクライアントインスタンス（src/client.ts）を共有します。ツールの実装はsrc/tools/にあり、ドメインごとに1ファイルで、src/index.tsのMcpServerに登録されます。サーバーはstdioトランスポート（stdin/stdout）で通信するため、すべてのデバッグログはconsole.logではなくconsole.error（stderr）を使用します。