Kaltura 模型上下文协议 (MCP) 服务器

Kaltura MCP 服务器是 模型上下文协议 (MCP) 的一个实现，它为 AI 模型提供了访问 Kaltura 媒体管理功能的能力。

概述

该服务器使 AI 模型能够：

• 将媒体上传到 Kaltura
• 检索媒体元数据
• 搜索媒体
• 管理分类
• 管理用户和权限

通过实现模型上下文协议，该服务器允许 AI 模型以标准化方式与 Kaltura 的 API 进行交互，从而更容易将 Kaltura 的功能集成到 AI 工作流中。

要求

• Python: 3.10 或更高版本（官方支持 3.10、3.11 和 3.12）
• 操作系统: Linux、macOS、Windows
• 依赖项: 请参阅 pyproject.toml 获取完整列表

仓库结构

kaltura-mcp-public 仓库包含了完整的、自包含的 Kaltura MCP 服务器实现，包括：

• 所有必要的代码
• 全面的文档
• Docker 支持
• 设置脚本
• 示例客户端
• 测试脚本

安装

使用 Docker

选项 1: 使用预构建的 Docker 镜像

最简单的方法是使用我们的预构建多架构 Docker 镜像（支持 x86_64/amd64 和 ARM64/Apple Silicon）：

bash

拉取最新镜像

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 本地构建

或者，您也可以在本地构建镜像：

bash

克隆仓库

git clone https://github.com/zoharbabin/kaltura-mcp.git
cd kaltura-mcp

使用 Docker Compose 构建并运行

docker-compose up

手动安装

bash

克隆仓库

git clone https://github.com/zoharbabin/kaltura-mcp.git
cd kaltura-mcp

创建虚拟环境（需要 Python 3.10 或更高版本）

python -m venv venv
source venv/bin/activate # 在 Windows 上: venvScriptsactivate

安装依赖项

pip install -e .

配置服务器

cp config.yaml.example config.yaml

使用您的 Kaltura API 凭证编辑 config.yaml

运行服务器

python -m kaltura_mcp.server

配置

Kaltura MCP 服务器支持统一的配置系统，支持 YAML 和 JSON 格式。要开始使用，请执行以下步骤：

1. 将 config.yaml.example 复制为 config.yaml 并使用您的 Kaltura API 凭证进行编辑：

yaml
kaltura:
partner_id: YOUR_PARTNER_ID
admin_secret: YOUR_ADMIN_SECRET
user_id: YOUR_USER_ID
service_url: https://www.kaltura.com/api_v3

1. 您也可以使用环境变量进行配置：

bash
export KALTURA_PARTNER_ID=YOUR_PARTNER_ID
export KALTURA_ADMIN_SECRET=YOUR_ADMIN_SECRET
export KALTURA_USER_ID=YOUR_USER_ID

有关更详细的配置选项，请参阅 配置指南。

使用

与 Claude 一起使用

要将 Kaltura MCP 服务器与 Claude 一起使用，请参阅 与 Claude 一起使用 指南。

与 MCP CLI 一起使用

要将 Kaltura MCP 服务器与 MCP CLI 一起使用，请参阅 与 MCP CLI 一起使用 指南。

编程方式使用

要编程方式使用 Kaltura MCP 服务器，请参阅 示例 目录。

可用工具

Kaltura MCP 服务器提供以下工具：

• media_upload: 将媒体文件上传到 Kaltura
• media_get: 检索媒体元数据
• media_update: 更新媒体元数据
• media_delete: 删除媒体
• category_list: 列出分类
• category_get: 检索分类元数据
• category_add: 添加新分类
• category_update: 更新分类元数据
• category_delete: 删除分类
• user_list: 列出用户
• user_get: 检索用户元数据
• user_add: 添加新用户- user_update: 更新用户元数据
• user_delete: 删除用户

可用资源

Kaltura MCP 服务器提供以下资源：

• media://{entry_id}: 媒体条目元数据
• category://{category_id}: 分类元数据
• user://{user_id}: 用户元数据

贡献指南

有关如何为本项目贡献的详细信息，请参阅 CONTRIBUTING.md。

许可证

本项目根据 AGPLv3 许可证授权 - 详情请参见 LICENSE 文件。