ShotGrid MCP Server

简介

ShotGrid MCP 服务器是一个基于 fastmcp 的高性能实现，为 Autodesk ShotGrid/Flow 生产跟踪系统提供模型上下文协议服务。

特性

• 🚀 高性能 MCP 实现
• 🛠️ 完整的 CRUD 操作支持
• 🖼️ 专用缩略图处理工具
• 🔄 高效连接池管理
• ✅ 全面的测试覆盖

安装

# 使用 UV 安装（推荐）
uv pip install shotgrid-mcp-server

# 或使用标准 pip
pip install shotgrid-mcp-server

配置

创建 .env 文件或设置环境变量：

SHOTGRID_URL=your_shotgrid_url
SHOTGRID_SCRIPT_NAME=your_script_name
SHOTGRID_SCRIPT_KEY=your_script_key

运行服务器

# 开发模式
uv run fastmcp dev src/shotgrid_mcp_server/server.py:app

# 生产模式
shotgrid-mcp-server

MCP 客户端配置

在客户端配置中添加：

{
  "mcpServers": {
    "shotgrid-server": {
      "command": "uvx",
      "args": ["shotgrid-mcp-server"],
      "env": {
        "SHOTGRID_SCRIPT_NAME": "your_script_name",
        "SHOTGRID_SCRIPT_KEY": "your_script_key",
        "SHOTGRID_URL": "your_shotgrid_url"
      },
      "disabled": false,
      "alwaysAllow": [
        "search_entities", "create_entity", "batch_create", 
        "find_entity", "get_entity_types", "update_entity",
        "download_thumbnail", "batch_update", "delete_entity", 
        "batch_delete"
      ]
    }
  }
}

可用工具

• create: 创建实体
• read: 读取实体信息
• update: 更新实体数据
• delete: 删除实体
• download_thumbnail: 下载缩略图
• upload_thumbnail: 上传缩略图

开发环境设置

# 克隆仓库
git clone https://github.com/loonghao/shotgrid-mcp-server.git
cd shotgrid-mcp-server

# 安装开发依赖
pip install -r requirements-dev.txt

# 运行测试
nox -s tests

# 代码检查
nox -s lint

更多信息

详细文档请参阅项目 GitHub 仓库的 /docs 目录或查看项目主页。