Kaltura MCP

🚀 Kaltura 模型上下文協議（MCP）服務器

Kaltura MCP 服務器實現了 模型上下文協議 (MCP)，該協議賦予了 AI 模型與 Kaltura 媒體管理功能進行交互的能力。

🚀 快速開始

Kaltura MCP 服務器讓 AI 模型能夠與 Kaltura 的 API 以標準方式交互，實現上傳媒體、獲取媒體元數據、搜索媒體、管理類別以及管理用戶和權限等功能，簡化了將 Kaltura 功能集成到 AI 工作流的過程。

運行以下命令即可快速啟動服務器：

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

訪問 http://localhost:8000 查看文檔。

✨ 主要特性

此服務器使 AI 模型能夠：

• 上傳媒體到 Kaltura
• 獲取媒體元數據
• 搜索媒體
• 管理類別
• 管理用戶和權限

📦 安裝指南

要求

• Python：3.10 或更高版本（官方支持 3.10、3.11、3.12）
• 操作系統：Linux、macOS、Windows
• 依賴項：請參見 pyproject.toml 以獲取完整列表

安裝方式

使用 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

📚 詳細文檔

倉庫結構

kaltura-mcp-public 倉庫包含完整的、自給自足的 Kaltura MCP 服務器實現，包括：

• 所有必要的代碼
• 完整的文檔
• Docker 支持
• 安裝腳本
• 示例客戶端
• 測試腳本

配置

默認配置文件為 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)

🤝 貢獻

有關如何為該項目做出貢獻的詳細信息，請參閱 CONTRIBUTING.md。

📄 許可證

本項目根據 AGPLv3 許可證發佈，許可證內容請參見 LICENSE 文件。