# 安装 KeyShot MCP

- 类型: MCP 工具
- 说明: 通过无头脚本控制本地 KeyShot 场景、相机与渲染流程。
- 仓库: https://github.com/truman-t3/keyshot-mcp

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "KeyShot MCP" MCP 服务：
执行：claude mcp add 'io-github-truman-t3-keyshot-mcp' -- npx -y keyshot-mcp
```

### Codex
```
请帮我安装 askskill 上的 "KeyShot MCP" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-truman-t3-keyshot-mcp]
command = "npx"
args = ["-y","keyshot-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "KeyShot MCP" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-truman-t3-keyshot-mcp": { "command": "npx", "args": ["-y","keyshot-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env KEYSHOT_HEADLESS_EXE=YOUR_VALUE --env KEYSHOT_OUTPUT_DIR=YOUR_VALUE --env KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=YOUR_VALUE --env KEYSHOT_TIMEOUT_MS=YOUR_VALUE --env KEYSHOT_LICENSE_ARGS=YOUR_VALUE --env KEYSHOT_MATERIAL_PRESETS=YOUR_VALUE --env KEYSHOT_CAMERA_PRESETS=YOUR_VALUE --transport stdio io-github-truman-t3-keyshot-mcp -- npx -y keyshot-mcp
```
需要环境变量：KEYSHOT_HEADLESS_EXE, KEYSHOT_OUTPUT_DIR, KEYSHOT_ALLOW_EXTERNAL_OUTPUTS, KEYSHOT_TIMEOUT_MS, KEYSHOT_LICENSE_ARGS, KEYSHOT_MATERIAL_PRESETS, KEYSHOT_CAMERA_PRESETS

### Codex
```bash
codex mcp add --env KEYSHOT_HEADLESS_EXE=YOUR_VALUE --env KEYSHOT_OUTPUT_DIR=YOUR_VALUE --env KEYSHOT_ALLOW_EXTERNAL_OUTPUTS=YOUR_VALUE --env KEYSHOT_TIMEOUT_MS=YOUR_VALUE --env KEYSHOT_LICENSE_ARGS=YOUR_VALUE --env KEYSHOT_MATERIAL_PRESETS=YOUR_VALUE --env KEYSHOT_CAMERA_PRESETS=YOUR_VALUE io-github-truman-t3-keyshot-mcp -- npx -y keyshot-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-truman-t3-keyshot-mcp]
command = "npx"
args = ["-y","keyshot-mcp"]

[mcp_servers.io-github-truman-t3-keyshot-mcp.env]
KEYSHOT_HEADLESS_EXE = "YOUR_VALUE"
KEYSHOT_OUTPUT_DIR = "YOUR_VALUE"
KEYSHOT_ALLOW_EXTERNAL_OUTPUTS = "YOUR_VALUE"
KEYSHOT_TIMEOUT_MS = "YOUR_VALUE"
KEYSHOT_LICENSE_ARGS = "YOUR_VALUE"
KEYSHOT_MATERIAL_PRESETS = "YOUR_VALUE"
KEYSHOT_CAMERA_PRESETS = "YOUR_VALUE"
```
需要环境变量：KEYSHOT_HEADLESS_EXE, KEYSHOT_OUTPUT_DIR, KEYSHOT_ALLOW_EXTERNAL_OUTPUTS, KEYSHOT_TIMEOUT_MS, KEYSHOT_LICENSE_ARGS, KEYSHOT_MATERIAL_PRESETS, KEYSHOT_CAMERA_PRESETS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-truman-t3-keyshot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "keyshot-mcp"
      ],
      "env": {
        "KEYSHOT_HEADLESS_EXE": "YOUR_VALUE",
        "KEYSHOT_OUTPUT_DIR": "YOUR_VALUE",
        "KEYSHOT_ALLOW_EXTERNAL_OUTPUTS": "YOUR_VALUE",
        "KEYSHOT_TIMEOUT_MS": "YOUR_VALUE",
        "KEYSHOT_LICENSE_ARGS": "YOUR_VALUE",
        "KEYSHOT_MATERIAL_PRESETS": "YOUR_VALUE",
        "KEYSHOT_CAMERA_PRESETS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-truman-t3-keyshot-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImtleXNob3QtbWNwIl0sImVudiI6eyJLRVlTSE9UX0hFQURMRVNTX0VYRSI6IllPVVJfVkFMVUUiLCJLRVlTSE9UX09VVFBVVF9ESVIiOiJZT1VSX1ZBTFVFIiwiS0VZU0hPVF9BTExPV19FWFRFUk5BTF9PVVRQVVRTIjoiWU9VUl9WQUxVRSIsIktFWVNIT1RfVElNRU9VVF9NUyI6IllPVVJfVkFMVUUiLCJLRVlTSE9UX0xJQ0VOU0VfQVJHUyI6IllPVVJfVkFMVUUiLCJLRVlTSE9UX01BVEVSSUFMX1BSRVNFVFMiOiJZT1VSX1ZBTFVFIiwiS0VZU0hPVF9DQU1FUkFfUFJFU0VUUyI6IllPVVJfVkFMVUUifX0
需要环境变量：KEYSHOT_HEADLESS_EXE, KEYSHOT_OUTPUT_DIR, KEYSHOT_ALLOW_EXTERNAL_OUTPUTS, KEYSHOT_TIMEOUT_MS, KEYSHOT_LICENSE_ARGS, KEYSHOT_MATERIAL_PRESETS, KEYSHOT_CAMERA_PRESETS