ShotGrid MCP服务器
A. 模型上下文协议（MCP） 服务器，为AI助手提供对Autodesk ShotGrid（流生产跟踪）的无缝访问
英语| 简体中文
](https://pypi.org/project/shotgrid-mcp-server/) ](https://badge.fury.io/py/shotgrid-mcp-server)   ](https://pepy.tech/project/shotgrid-mcp-server) ](https://pepy.tech/project/shotgrid-mcp-server) ](https://pepy.tech/project/shotgrid-mcp-server)
概述
ShotGrid MCP服务器使Claude、Cursor和VS Code Copilot等AI助手能够直接与您的ShotGrid（流生产跟踪）数据交互。建立在 FastMCP，它在人工智能工具和生产跟踪工作流之间提供了一座高性能的桥梁。
演示
在代码编辑器中配置ShotGrid MCP
Configure ShotGrid MCP in Code Editor
1.查询任务计划和工作量可视化
Query Task Schedule & Workload Visualization
提示： Query the team's task schedule for the past week, calculate workload rate based on 8 hours per day, and visualize it in web format
2.批量创建资产和分配任务
Batch Create Assets & Assign Tasks
提示： Batch create the recommended hero characters in the shotgrid Demo:Animation project, categorize them as characters, use the FilmVFX-CharacterAsset task template, assign tasks to Yang Zhuo, with start and end dates set to next week
3.时间日志统计和可视化
TimeLog Statistics & Visualization
提示： Query timelog data from shotgrid and visualize it in web format
4.部门效率统计并发送至WeCom
Department Efficiency Statistics & Send to WeCom
提示： Calculate department efficiency and send the data to WeCom. Efficiency formula: Efficiency = Task bid / Timelog hours
更多示例
特性
| 类别 | 亮点 |
|---|---|
| 40+工具 | 完成CRUD操作、批处理、缩略图、笔记、播放列表 |
| 运输 | stdio（本地）、HTTP（远程）、ASGI（生产） |
| 演出 | 连接池、模式缓存、延迟初始化 |
| 部署 | FastMCP Cloud、Docker、uvicon/gunicorn、任何ASGI服务器 |
| 平台 | Windows、macOS、Linux |
快速开始
安装
# Using uv (recommended)
uv pip install shotgrid-mcp-server
# Or using pip
pip install shotgrid-mcp-server配置
设置您的ShotGrid凭据：
export SHOTGRID_URL="https://your-site.shotgunstudio.com"
export SHOTGRID_SCRIPT_NAME="your_script_name"
export SHOTGRID_SCRIPT_KEY="your_script_key"用法
stdio传输（默认）-适用于Claude桌面、光标等。
uvx shotgrid-mcp-serverHTTP传输-用于远程访问
uvx shotgrid-mcp-server http --host 0.0.0.0 --port 8000MCP客户端配置
将服务器添加到MCP客户端配置中：
克劳德桌面版
{
"mcpServers": {
"shotgrid": {
"command": "uvx",
"args": ["shotgrid-mcp-server"],
"env": {
"SHOTGRID_URL": "https://your-site.shotgunstudio.com",
"SHOTGRID_SCRIPT_NAME": "your_script_name",
"SHOTGRID_SCRIPT_KEY": "your_script_key"
}
}
}
}游标/VS代码/其他MCP客户端
{
"mcpServers": {
"shotgrid": {
"command": "uvx",
"args": ["shotgrid-mcp-server"],
"env": {
"SHOTGRID_URL": "https://your-site.shotgunstudio.com",
"SHOTGRID_SCRIPT_NAME": "your_script_name",
"SHOTGRID_SCRIPT_KEY": "your_script_key"
}
}
}
}HTTP传输（远程）
{
"mcpServers": {
"shotgrid": {
"url": "http://your-server:8000/mcp",
"transport": { "type": "http" }
}
}
}部署
| 方法 | 命令/设置 |
|---|---|
| FastMCP云 | 通过部署 fastmcp.cloud 随着 fastmcp_entry.py |
| ASGI | uvicorn shotgrid_mcp_server.asgi:app --host 0.0.0.0 --port 8000 |
| 码头工人 | 请参阅 部署指导 |
看 部署指导 详细说明。
可用工具
此服务器提供 40+工具 用于与ShotGrid交互：
| 类别 | 工具 |
|---|---|
| 增删改查 | create_entity, find_one_entity, search_entities, update_entity, delete_entity |
| 批次 | batch_create, batch_update, batch_delete |
| 媒体 | download_thumbnail, upload_thumbnail |
| 备注 | shotgrid.note.create, shotgrid.note.read, shotgrid.note.update |
| 播放列表 | create_playlist, find_playlists |
| 直接API | sg.find, sg.create, sg.update, sg.batch以及更多。.. |
示例提示
连接后，您可以询问您的AI助手：
- *“在Project X中查找上周更新的所有快照”*
- *“使用昨天的灯光渲染创建播放列表”*
- *“在SHOT_010中添加关于背景照明的注释”*
- *“汇总本月动画部门的时间日志”*
发展
# Clone and install
git clone https://github.com/loonghao/shotgrid-mcp-server.git
cd shotgrid-mcp-server
pip install -r requirements-dev.txt
# Run tests
nox -s tests
# Development server with hot reload
uv run fastmcp dev src/shotgrid_mcp_server/server.py:mcp文档
看 /docs 详细文档目录。
贡献
欢迎投稿！请遵循 Google Python 风格指南 并编写测试。
许可证
建筑
flowchart TB
subgraph Clients["🤖 MCP Clients"]
direction LR
CLAUDE["Claude Desktop"]
CURSOR["Cursor"]
VSCODE["VS Code"]
AI["Other AI"]
end
subgraph MCP["⚡ ShotGrid MCP Server"]
direction LR
TOOLS["40+ Tools"]
POOL["Connection Pool"]
SCHEMA["Schema Cache"]
end
subgraph ShotGrid["🎬 ShotGrid API"]
direction LR
P["Projects"]
S["Shots"]
A["Assets"]
T["Tasks"]
N["Notes"]
end
Clients -->|"MCP Protocol
stdio / http"| MCP
MCP -->|"REST API"| ShotGrid
style Clients fill:#2ecc71,stroke:#27ae60,color:#fff
style MCP fill:#3498db,stroke:#2980b9,color:#fff
style ShotGrid fill:#e74c3c,stroke:#c0392b,color:#fff
