loonghao/shotgrid-mcp-server

AI 어시스턴트에게 Autodesk ShotGrid (Flow Production Tracking)에 대한 원활한 접근 권한을 제공하는 Model Context Protocol (MCP) 서버

English | 简体中文

📖 Documentation | 中文文档

ShotGrid MCP Server는 Claude, Cursor, VS Code Copilot과 같은 AI 어시스턴트가 사용자의 ShotGrid (Flow Production Tracking) 데이터와 직접 상호작용할 수 있도록 지원합니다. FastMCP를 기반으로 구축되어 AI 도구와 제작 관리 (production tracking) 워크플로우 사이의 고성능 브릿지 역할을 제공합니다.

프롬프트 (Prompt): 지난 한 주 동안의 팀 작업 일정을 조회하고, 하루 8시간을 기준으로 업무 부하율 (workload rate)을 계산하여 웹 형식으로 시각화해줘

프롬프트 (Prompt): shotgrid Demo:Animation 프로젝트에서 권장되는 히어로 캐릭터들을 일괄 생성하고, 이를 캐릭터로 분류하며, FilmVFX-CharacterAsset 작업 템플릿을 사용해. 작업을 Yang Zhuo에게 할당하고 시작일과 종료일은 다음 주로 설정해줘

프롬프트 (Prompt): shotgrid에서 타임로그 (timelog) 데이터를 조회하고 웹 형식으로 시각화해줘

프롬프트 (Prompt): 부서 효율성을 계산하여 WeCom으로 데이터를 전송해줘. 효율성 공식: 효율성 = 작업 입찰가 (Task bid) / 타임로그 시간 (Timelog hours)

카테고리 (Category)	주요 특징 (Highlights)
40개 이상의 도구 (40+ Tools)	완전한 CRUD 작업, 일괄 처리 (batch processing), 썸네일, 노트, 플레이리스트
전송 (Transport)	stdio (로컬), HTTP (원격), ASGI (운영 환경)
성능 (Performance)	커넥션 풀링 (Connection pooling), 스키마 캐싱 (schema caching), 지연 초기화 (lazy initialization)
배포 (Deployment)	FastMCP Cloud, Docker, uvicorn/gunicorn, 모든 ASGI 서버
플랫폼 (Platform)	Windows, macOS, Linux

# uv 사용 (권장)
uv pip install shotgrid-mcp-server
# 또는 pip 사용
...

ShotGrid 인증 정보를 설정하세요:

export SHOTGRID_URL="https://your-site.shotgunstudio.com"
export SHOTGRID_SCRIPT_NAME="your_script_name"
export SHOTGRID_SCRIPT_KEY="your_script_key"

uvx shotgrid-mcp-server

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

MCP 클라이언트 설정에 서버를 추가하세요:

{
"mcpServers": {
"shotgrid": {
...

{
"mcpServers": {
"shotgrid": {
...

{
"mcpServers": {
"shotgrid": {
...

방법	명령 / 설정
FastMCP Cloud	fastmcp_entry.py를 사용하여 fastmcp.cloud를 통해 배포
ASGI	uvicorn shotgrid_mcp_server.asgi:app --host 0.0.0.0 --port 8000
Docker	배포 가이드(Deployment Guide) 참조

자세한 지침은 배포 가이드(Deployment Guide)를 참조하십시오.

이 서버는 ShotGrid와 상호작용하기 위한 **40개 이상의 도구 (tools)**를 제공합니다:

카테고리	도구 (Tools)
CRUD	create_entity, find_one_entity, search_entities, update_entity, delete_entity
일괄 처리 (Batch)	batch_create, batch_update, batch_delete
미디어 (Media)	download_thumbnail, upload_thumbnail
노트 (Notes)	shotgrid.note.create, shotgrid.note.read, shotgrid.note.update
플레이리스트 (Playlists)	create_playlist, find_playlists
직접 API (Direct API)	sg.find, sg.create, sg.update, sg.batch 및 기타...

연결되면 AI 어시스턴트에게 다음과 같이 요청할 수 있습니다:

"Project X에서 지난주에 업데이트된 모든 샷(shots)을 찾아줘"
"어제의 라이팅 렌더(lighting renders)를 포함하는 플레이리스트를 만들어줘"
"SHOT_010의 배경 라이팅(background lighting)에 대한 노트를 추가해줘"
"이번 달 애니메이션(Animation) 부서의 타임 로그(time logs)를 요약해줘"

# 클론 및 설치
git clone https://github.com/loonghao/shotgrid-mcp-server.git
cd shotgrid-mcp-server
...

자세한 문서는 /docs 디렉토리를 참조하십시오.

기여(Contributions)를 환영합니다! Google Python Style Guide를 준수하고 테스트를 작성해 주세요.

flowchart TB
subgraph Clients["🤖 MCP Clients"]
direction LR
...