使用说明
织机顾问
用于织机视频管理的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进行身份验证。要获取访问令牌,请执行以下操作:
- 在 Loom开发者门户
- 实现OAuth2授权流
- 在配置中使用返回的访问令牌
注: 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工厂生成