视频管理工具

提供Loom视频的列表、检索、编辑和合并功能的服务。

  • by m2ai-mcp-servers
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 m2ai-mcp-servers/loom-mcp

使用说明

织机顾问

用于织机视频管理的MCP服务器。提供列出、检索、编辑和合并织机屏幕录制的工具。

特性

  • 列表_录制_视频 -通过分页和文件夹过滤检索已录制视频列表
  • 获取_视频 -获取特定视频的详细信息
  • edit_video -通过修剪或提取剪辑来编辑视频
  • 合并视频 -将多个视频合并为一个

安装

pip install m2ai-mcp-loom-advisor

配置

所需的环境变量:

变量 描述
LOOM_ACCESS_TOKEN Loom API的OAuth2访问令牌

可选环境变量:

变量 描述 默认值
LOOM_BASE_URL Loom API基础URL https://api.loom.com/v1

获取访问令牌

Loom使用OAuth2进行身份验证。要获取访问令牌,请执行以下操作:

  1. 在 Loom开发者门户
  2. 实现OAuth2授权流
  3. 在配置中使用返回的访问令牌

注: Loom的公共API访问可能受到限制。企业用户可能具有额外的API功能。有关API访问详细信息,请联系Loom。

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "loom": {
      "command": "loom-advisor",
      "env": {
        "LOOM_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

或者直接用Python运行:

{
  "mcpServers": {
    "loom": {
      "command": "python",
      "args": ["-m", "loom_mcp.server"],
      "env": {
        "LOOM_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

工具

列表_录制_视频

从Loom检索录制的视频列表。

参数:

  • limit (可选):返回的最大视频数(1-100,默认50)
  • offset (可选):分页偏移量(默认值0)
  • folder_id (可选):按文件夹ID过滤视频

例子:

{
  "limit": 10,
  "offset": 0,
  "folder_id": "folder-abc"
}

获取_视频

检索特定视频的详细信息。

参数:

  • video_id (必填):视频的唯一标识符

例子:

{
  "video_id": "abc123"
}

edit_video

通过添加剪辑或修剪片段来编辑视频。

参数:

  • video_id (必填):视频的唯一标识符
  • editing_details (必填):包含编辑指令的对象
    • trim_start:从开始修剪的开始时间(秒)
    • trim_end:视频应结束的结束时间(秒)
    • clips:剪辑对象列表 start 和 end 时代
    • title:编辑视频的可选新标题
    • description:可选的新描述

例子:

{
  "video_id": "abc123",
  "editing_details": {
    "trim_start": 5,
    "trim_end": 120,
    "title": "Edited Demo"
  }
}

合并视频

将多个视频合并为一个合并视频。

参数:

  • video_ids (必填):要合并的视频ID列表(按顺序至少2个)
  • title (可选):合并视频的标题

例子:

{
  "video_ids": ["video-1", "video-2", "video-3"],
  "title": "Combined Demo"
}

发展

运行测试

# Activate virtual environment
source venv/bin/activate

# Run tests
pytest

# Run with coverage
pytest --cov=loom_mcp --cov-report=term-missing

代码质量

# Format and lint
ruff check src tests
ruff format src tests

# Type checking
mypy src

项目结构

loom-mcp/
├── src/
│   └── loom_mcp/
│       ├── __init__.py
│       ├── server.py          # MCP server entry point
│       ├── clients/
│       │   ├── __init__.py
│       │   └── loom.py        # Loom API client
│       └── tools/
│           ├── __init__.py
│           ├── list_recorded_videos.py
│           ├── get_video.py
│           ├── edit_video.py
│           └── merge_videos.py
├── tests/
│   ├── __init__.py
│   ├── conftest.py
│   ├── test_loom_client.py
│   ├── test_tools.py
│   └── test_server.py
├── pyproject.toml
├── README.md
└── .env.example

许可证

麻省理工学院


由GRIMLOCK MCP工厂生成