🎯 ShotGrid MCP Server

概述

ShotGrid MCP Server 可让 Claude、Cursor 和 VS Code Copilot 等 AI 助手直接与您的 ShotGrid (Flow Production Tracking) 数据交互。它基于 FastMCP 构建，为 AI 工具和制作跟踪工作流提供高性能桥接。

演示

0. 在代码编辑器中配置 ShotGrid MCP

1. 查询任务日程并可视化工作量

提示词： 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 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. 工时日志统计与可视化

提示词： Query timelog data from shotgrid and visualize it in web format

4. 部门效率统计并发送至 WeCom

提示词： Calculate department efficiency and send the data to WeCom. Efficiency formula: Efficiency = Task bid / Timelog hours

更多示例

功能特性

类别	亮点
40+ 个工具	完整的增删改查操作、批处理、缩略图、备注、播放列表
传输方式	stdio（本地）、HTTP（远程）、ASGI（生产环境）
性能	连接池、架构缓存、延迟初始化
技能	通过 MCP 提供打包的 Agent Skills (io.modelcontextprotocol/skills)
部署	FastMCP Cloud、Docker、uvicorn/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 Desktop、Cursor 等

uvx shotgrid-mcp-server

HTTP 传输 — 用于远程访问

uvx shotgrid-mcp-server http --host 0.0.0.0 --port 8000

MCP 客户端配置

将服务添加到 MCP 客户端配置中：

Claude Desktop

{
  "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"
      }
    }
  }
}

Cursor / VS Code / 其他 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": {
      "type": "http",
      "url": "http://your-server:8000/mcp"
    }
  }
}

部署

方法	命令 / 设置
FastMCP Cloud	通过 fastmcp.cloud 使用 fastmcp_entry.py 部署
ASGI	uvicorn shotgrid_mcp_server.asgi:app --host 0.0.0.0 --port 8000
Docker	请参阅部署指南

详细说明请参阅部署指南。

可用工具

此服务提供 40+ 个工具，用于与 ShotGrid 交互：

类别	工具
CRUD	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
MCP Apps	shotgrid_dashboard（交互式状态仪表板）
直接 API	sg.find、sg.create、sg.update、sg.batch 等……

MCP Apps

shotgrid_dashboard 是一个 MCP App：它会返回数据和交互式 UI。该工具会在其 _meta.ui.resourceUri 中声明 ui://shotgrid/dashboard，宿主会在沙盒 iframe 中呈现该资源。

不支持 MCP Apps 的宿主会自动收到相同的摘要纯文本。

UI 已打包为单个独立 HTML 文件，因此生产环境无需 Node 运行时。有关线格式和重建说明，请参阅 MCP Apps 指南。

python scripts/verify_mcp_app.py

示例提示词

连接后，你可以向 AI 助手提问：

• “查找 Project X 中上周更新的所有镜头”
• “创建一个包含昨天灯光渲染的播放列表”
• “为 SHOT_010 添加一条关于背景灯光的注释”
• “汇总动画部门本月的工时记录”
• “显示 Project X 的任务状态仪表板”

开发

# 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

# Verify the Skills extension against a live HTTP server
uv run python scripts/verify_skills_extension.py

文档

详细文档请参阅 /docs 目录。

贡献

欢迎贡献！请遵循 Google Python 风格指南，编写测试，并使用 Conventional Commits——提交消息会影响版本号和更新日志。有关如何发布版本，请参阅 RELEASE.md。

许可证

MIT

架构

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<br/>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