🎯 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 以上のツール	CRUD 操作一式、一括処理、サムネイル、ノート、プレイリスト
トランスポート	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_entry.py を使って fastmcp.cloud 経由でデプロイします
ASGI	uvicorn shotgrid_mcp_server.asgi:app --host 0.0.0.0 --port 8000
Docker	デプロイガイドを参照してください

詳しい手順については、デプロイガイドを参照してください。

利用可能なツール

このサーバーは、ShotGrid とやり取りするための40 以上のツールを提供します。

カテゴリ	ツール
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 Style Guideに従い、テストを作成し、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