KeyShot MCP MCP Server

Name: KeyShot MCP MCP Server
Author: io.github.truman-t3

io.github.truman-t3/keyshot-mcp

Repository Registry

What is the KeyShot MCP MCP server?

Control local KeyShot scenes, cameras, environments, and renders through headless scripting.

How to install KeyShot MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

KEYSHOT_HEADLESS_EXE
required
Absolute path to KeyShot headless, or a command available on PATH.
KEYSHOT_OUTPUT_DIR
Root directory for rendered images and saved scenes.
KEYSHOT_ALLOW_EXTERNAL_OUTPUTS
Set to true only when output paths outside KEYSHOT_OUTPUT_DIR are required.
KEYSHOT_TIMEOUT_MS
Timeout in milliseconds for one KeyShot headless process.
KEYSHOT_LICENSE_ARGS
Optional additional KeyShot launch arguments.
KEYSHOT_MATERIAL_PRESETS
Optional path to a user-managed material preset JSON file.
KEYSHOT_CAMERA_PRESETS
Optional path to a user-managed camera preset JSON file.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "keyshot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<YOUR_KEYSHOT_HEADLESS_EXE>",
        "KEYSHOT_OUTPUT_DIR": "<YOUR_KEYSHOT_OUTPUT_DIR>",
        "KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "<YOUR_KEYSHOT_ALLOW_EXTERNAL_OUTPUTS>",
        "KEYSHOT_TIMEOUT_MS": "<YOUR_KEYSHOT_TIMEOUT_MS>",
        "KEYSHOT_LICENSE_ARGS": "<YOUR_KEYSHOT_LICENSE_ARGS>",
        "KEYSHOT_MATERIAL_PRESETS": "<YOUR_KEYSHOT_MATERIAL_PRESETS>",
        "KEYSHOT_CAMERA_PRESETS": "<YOUR_KEYSHOT_CAMERA_PRESETS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "keyshot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<YOUR_KEYSHOT_HEADLESS_EXE>",
        "KEYSHOT_OUTPUT_DIR": "<YOUR_KEYSHOT_OUTPUT_DIR>",
        "KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "<YOUR_KEYSHOT_ALLOW_EXTERNAL_OUTPUTS>",
        "KEYSHOT_TIMEOUT_MS": "<YOUR_KEYSHOT_TIMEOUT_MS>",
        "KEYSHOT_LICENSE_ARGS": "<YOUR_KEYSHOT_LICENSE_ARGS>",
        "KEYSHOT_MATERIAL_PRESETS": "<YOUR_KEYSHOT_MATERIAL_PRESETS>",
        "KEYSHOT_CAMERA_PRESETS": "<YOUR_KEYSHOT_CAMERA_PRESETS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "keyshot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<YOUR_KEYSHOT_HEADLESS_EXE>",
        "KEYSHOT_OUTPUT_DIR": "<YOUR_KEYSHOT_OUTPUT_DIR>",
        "KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "<YOUR_KEYSHOT_ALLOW_EXTERNAL_OUTPUTS>",
        "KEYSHOT_TIMEOUT_MS": "<YOUR_KEYSHOT_TIMEOUT_MS>",
        "KEYSHOT_LICENSE_ARGS": "<YOUR_KEYSHOT_LICENSE_ARGS>",
        "KEYSHOT_MATERIAL_PRESETS": "<YOUR_KEYSHOT_MATERIAL_PRESETS>",
        "KEYSHOT_CAMERA_PRESETS": "<YOUR_KEYSHOT_CAMERA_PRESETS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "keyshot-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "<YOUR_KEYSHOT_HEADLESS_EXE>",
        "KEYSHOT_OUTPUT_DIR": "<YOUR_KEYSHOT_OUTPUT_DIR>",
        "KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "<YOUR_KEYSHOT_ALLOW_EXTERNAL_OUTPUTS>",
        "KEYSHOT_TIMEOUT_MS": "<YOUR_KEYSHOT_TIMEOUT_MS>",
        "KEYSHOT_LICENSE_ARGS": "<YOUR_KEYSHOT_LICENSE_ARGS>",
        "KEYSHOT_MATERIAL_PRESETS": "<YOUR_KEYSHOT_MATERIAL_PRESETS>",
        "KEYSHOT_CAMERA_PRESETS": "<YOUR_KEYSHOT_CAMERA_PRESETS>"
      }
    }
  }
}

Claude Code

claude mcp add keyshot-mcp --env KEYSHOT_HEADLESS_EXE=<YOUR_KEYSHOT_HEADLESS_EXE> --env KEYSHOT_OUTPUT_DIR=<YOUR_KEYSHOT_OUTPUT_DIR> --env KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=<YOUR_KEYSHOT_ALLOW_EXTERNAL_OUTPUTS> --env KEYSHOT_TIMEOUT_MS=<YOUR_KEYSHOT_TIMEOUT_MS> --env KEYSHOT_LICENSE_ARGS=<YOUR_KEYSHOT_LICENSE_ARGS> --env KEYSHOT_MATERIAL_PRESETS=<YOUR_KEYSHOT_MATERIAL_PRESETS> --env KEYSHOT_CAMERA_PRESETS=<YOUR_KEYSHOT_CAMERA_PRESETS> -- npx -y keyshot-mcp