Kaltura MCP

🚀 Kaltura モデルコンテキストプロトコル（MCP）サーバー

Kaltura MCP サーバーは、モデルコンテキストプロトコル (MCP) の実装です。このプロトコルにより、AI モデルは Kaltura のメディア管理機能と相互作用することが可能になります。

🚀 クイックスタート

Kaltura MCP サーバーを使用することで、AI モデルは Kaltura のメディア管理機能と標準的な方法でやり取りすることができます。以下に、サーバーをすぐに起動する方法を示します。

docker run -p 8000:8000 ghcr.io/zoharbabin/kaltura-mcp:latest

http://localhost:8000 にアクセスして、ドキュメントを確認しましょう。

✨ 主な機能

このサーバーにより、AI モデルは以下のことが可能になります。

• Kaltura へのメディアのアップロード
• メディアメタデータの取得
• メディアの検索
• カテゴリの管理
• ユーザーと権限の管理

モデルコンテキストプロトコルを実装することで、AI モデルは Kaltura の API と標準的な方法でやり取りでき、Kaltura の機能を AI ワークフローに簡単に統合できます。

📦 インストール

Docker を使用する場合

方法 1：事前構築済みの Docker イメージを使用する

最も簡単な方法は、事前構築済みのマルチアーキテクチャ Docker イメージ（x86_64/amd64 と ARM64/Apple Silicon をサポート）を使用することです。

# 最新のイメージを取得
docker pull ghcr.io/zoharbabin/kaltura-mcp:latest

# 設定ファイルを作成
cp config.yaml.example config.yaml
# Kaltura API の認証情報を使用して config.yaml を編集

# コンテナを実行
docker run -p 8000:8000 -v $(pwd)/config.yaml:/app/config.yaml ghcr.io/zoharbabin/kaltura-mcp:latest

方法 2：Docker Compose を使用してローカルで構築する

また、ローカルでイメージを構築することもできます。

# リポジトリをクローン
git clone https://github.com/zoharbabin/kaltura-mcp.git
cd kaltura-mcp

# Docker Compose を使用して構築し、実行
docker-compose up

手動インストール

# リポジトリをクローン
git clone https://github.com/zoharbabin/kaltura-mcp.git
cd kaltura-mcp

# 仮想環境を作成（Python 3.10 以上が必要）
python -m venv venv
source venv/bin/activate  # Windows の場合は：venv\Scripts\activate

# 依存関係をインストール
pip install -e .

# サーバーを設定
cp config.yaml.example config.yaml
# Kaltura API の認証情報を使用して config.yaml を編集

# サーバーを起動
python -m kaltura_mcp_server

📚 ドキュメント

設定

デフォルトの設定ファイルは config.yaml で、リポジトリのルートディレクトリにあります。以下の設定を指定できます。

bind:
  port: 8000  # バインドするポート、デフォルトは 8000
log_level: INFO  # ログレベル（DEBUG、INFO、WARNING、ERROR、CRITICAL）

💻 使用例

基本的な使用法

コマンドラインツール（CLI）

kaltura-mcp-cli は、Kaltura MCP サーバーとやり取りするためのコマンドラインツールです。以下のようにインストールできます。

pip install kaltura-mcp-cli

使用例：

# メディアメタデータを取得
kaltura-mcp-cli get-media-metadata --id=1234

# メディアを検索
kaltura-mcp-cli search-media --query="猫"

# ユーザーを作成
kaltura-mcp-cli create-user --name="新ユーザー" --email="new@example.com"

Python クライアントライブラリ

kaltura-mcp-client は、Kaltura MCP サーバーとやり取りするための Python ライブラリです。以下のようにインストールできます。

pip install kaltura-mcp-client

使用例：

from kaltura_mcp_client import KalturaMCPClient

# クライアントを初期化
client = KalturaMCPClient(
    host="localhost",
    port=8000,
    insecure=True  # SSL 検証を無効にする（テスト環境）
)

# メディアメタデータを取得
metadata = client.get_media_metadata(id=1234)
print(metadata)

# メディアを検索
results = client.search_media(query="猫")
print(results)

🔧 技術詳細

kaltura-mcp-public リポジトリには、完全で自立した Kaltura MCP サーバーの実装が含まれています。

• 必要なすべてのコード
• 完全なドキュメント
• Docker サポート
• インストールスクリプト
• サンプルクライアント
• テストスクリプト

🤝 貢献

このプロジェクトに貢献する方法の詳細については、CONTRIBUTING.md を参照してください。

📄 ライセンス

本プロジェクトは AGPLv3 ライセンスの下で公開されています。ライセンスの内容は LICENSE ファイルを参照してください。