ATEM MCP Server

ATEM MCP服务器

使用模型上下文协议通过AI助手控制Blackmagic ATEM视频切换器。使用 克劳德桌面, claude.ai, 克劳德·莫比尔, 光标，以及任何兼容MCP的客户端。

用简单的英语与您的切换器交谈： *“将相机2置于程序中并溶解”* 或 *“开始流式传输和录制”* 或 *“运行宏3。”*

支持两者 本地 （stdio）和 远程 （OAuth 2.0的流式HTTP）传输。

运作原理

You (natural language)
  │
  ▼
Claude (Anthropic Cloud)
  │ translates to MCP tool calls
  ▼
ATEM MCP Server (your Mac/PC)
  │ uses atem-connection library
  ▼
ATEM Switcher (network)
  │ executes commands
  ▼
ATEM Software Control / hardware
  │ reflects changes in real time

支持的ATEM型号

底层 atem-connection 库（由NRK/Sofie提供）支持每一代ATEM：

• ATEM迷你、迷你专业、迷你专业ISO、迷你极端、迷你极端ISO
• ATEM电视演播室HD、HD8、HD8 ISO
• ATEM 1 M/E、2 M/E、4 M/E制作工作室/星座
• ATEM SDI、SDI Pro ISO、SDI Extreme ISO
• 以及所有其他Blackmagic ATEM型号

快速开始

1.安装

cd atem-mcp-server
npm install
npm run build

2.配置克劳德桌面

编辑您的Claude Desktop配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "atem": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/atem-mcp-server/dist/index.js"],
      "env": {
        "ATEM_HOST": "192.168.1.100"
      }
    }
  }
}

注： 替换 /opt/homebrew/bin/node 使用完整的Node.js路径（运行 which node 找到它）。用ATEM的地址替换IP。

3.重新启动克劳德桌面

退出并重新启动Claude Desktop。你应该看看锤子(🔨) 指示MCP工具可用的图标。

4.开始与你的切换器交谈

• *“通过192.168.1.100连接到我的ATEM”*
• *“显示当前切换器状态”*
• *“将相机3置于预览状态并将其溶解”*
• *“褪色成黑色”*

环境变量

如果 ATEM_HOST 设置后，服务器将在启动时自动连接。否则，请使用 atem_connect 手动连接。

远程访问（claude.ai、claude Mobile、HTTP）

HTTP传输将MCP服务器暴露为内置OAuth 2.0的web端点。这允许从以下位置进行远程访问 claude.ai, 克劳德·莫比尔，以及任何支持HTTP的MCP客户端。

快速启动（HTTP模式）

TRANSPORT=http BASE_URL=https://atem.yourdomain.com ATEM_HOST=192.168.1.100 node dist/index.js

服务器在端口3000上启动时具有：

• MCP端点： POST /mcp （需要不记名代币）
• OAuth 2.0： 全自动配置流程（发现、注册、授权、令牌交换）
• 健康检查： GET /health

从claude.ai连接

1. 首选 claude.ai/设置/连接器
2. 点击 添加自定义连接器
3. 输入您的MCP URL（例如。， https://atem.yourdomain.com/mcp)
4. 点击 连接 --OAuth流自动完成
5. 开始对话并远程控制您的ATEM

从克劳德桌面（远程）连接

{
  "mcpServers": {
    "atem": {
      "url": "https://atem.yourdomain.com/mcp"
    }
  }
}

不 command 或 args 需要--服务器远程运行。

OAuth 2.0实现

HTTP服务器为MCP身份验证实现了完整的OAuth 2.0流程：

OAuth服务器自动提供令牌，无需用户交互，专为个人/可信使用而设计。对于生产环境，考虑添加适当的身份验证。

通过Cloudflare隧道进行公开

使用命名的Cloudflare隧道作为永久URL——没有端口转发，没有动态DNS，没有更改URL。

先决条件

• 自由的 云耀 账户
• 由Cloudflare DNS管理的域
• cloudflared 已安装CLI(brew install cloudflared 在macOS上）

设置

1.验证并创建隧道

cloudflared login
cloudflared tunnel create atem-mcp

注意隧道ID（UUID）。

2.路由DNS

cloudflared tunnel route dns atem-mcp atem.yourdomain.com

3.创建配置文件 (~/.cloudflared/config.yml)

tunnel: 
credentials-file: ~/.cloudflared/.json

ingress:
  - hostname: atem.yourdomain.com
    service: http://localhost:3000
  - service: http_status:404

4.启动服务器和隧道

# Terminal 1: MCP server
TRANSPORT=http BASE_URL=https://atem.yourdomain.com ATEM_HOST=192.168.1.100 node dist/index.js

# Terminal 2: Cloudflare tunnel
cloudflared tunnel run atem-mcp

您的MCP端点现在位于 https://atem.yourdomain.com/mcp.

关键：禁用Cloudflare AI Bot阻止

如果您使用Cloudflare并从claude.ai连接，则必须禁用ai bot阻止，否则claude.ai的请求将被403静默阻止。

Claude.ai的后端使用 Claude-User 来自Google Cloud Platform IP的用户代理。Cloudflare的“阻止AI训练机器人”管理规则在这些请求到达您的服务器之前阻止它们。

要修复：

1. 首选 Cloudflare仪表板 >选择您的域名
2. 在 概述 页面，查找 “阻止人工智能训练机器人” 在右侧边栏上
3. 使从…变成 “阻止所有页面” 到 “不要阻塞（允许爬虫）”

您可以在中验证 安全>分析>事件 --被阻止的请求显示为 Service: Managed rules, Rule: Manage AI bots, User agent: Claude-User.

作为后台服务运行（macOS）

sudo cloudflared service install

这将创建一个启动守护进程，在启动时启动隧道。

有用的命令

cloudflared tunnel list              # List all tunnels
cloudflared tunnel info atem-mcp     # Show tunnel details
cloudflared tunnel cleanup atem-mcp  # Remove stale connections
cloudflared tunnel delete atem-mcp   # Delete the tunnel entirely

可用工具（58个工具）

连接

切换

过渡

路线和钥匙

宏

录制和流媒体

超级来源

混音器（Fairlight+经典）

音频工具自动检测混音器类型。 费尔莱特 用于ATEM Mini Extreme、Constellation和较新型号。 经典 用于ATEM Mini、Mini Pro和旧型号。

Fairlight EQ&Dynamics

适用于配备Fairlight音频的ATEM型号（Mini Extreme、Constellation及更新型号）的全参数均衡器、压缩器、限制器和门/扩展器控制。包括常见用例的EQ预设。

通用输入ID

对话示例

基本切换：

“将摄像头1设置为程序”\ “将预览设置为相机3，并进行2秒的溶解”\ “剪切成彩色条”

显示设置：

“设置过渡样式以与45帧率混合”\ “将摄像头1连接到辅助1，用于置信度监视器”\ “播放DSK1的下三分之一图形”

流媒体/录制：

“开始流式传输和录制”\ “录制状态如何？”\ “停止流媒体播放，但继续录制”

音频（Fairlight&Classic）：

“将摄像头2音频降低5 dB” “将摄像头1音频设置为音频跟随视频模式” “将输入端3的音频静音” “将主输出设置为-3dB” “显示混音器状态”

Fairlight EQ&Dynamics：

“将人声均衡器预设应用于麦克风1” “以3kHz的频率增强摄像头2音频的存在感” “添加一个压缩器到麦克风1--4:1的比率，阈值为-20dB” “屏蔽麦克风2，使其在-40dB以下关闭” “在-3dB的主机上安装一个限制器” “显示输入1的EQ和动态状态” “将摄像头1上的所有均衡器重置为平坦”

图库和活动扬声器：

“前往画廊” “与2、3和5号摄像机上的客人一起去画廊” “切换到活动扬声器” “自动开关” *（开始连续跟随当前扬声器）* “自动切换主机+有源扬声器” *（主持人讲话时全屏，客人讲话时并排）* “自动关闭” “与摄像头1和2并排设置” “用3切到主机”

保存和召回外观：

“将此外观另存为播客4” “加载播客4” “加载带有摄像头2、3、6、7的播客4” *（重用不同来源的布局几何图形）* “我保存了什么外观？” “删除旧的_test外观”

建筑

此服务器使用 atem连接 该库（由NRK/Sofie TV Automation提供）通过UDP实现Blackmagic专有的ATEM协议。它与ATEM软件控制使用的协议相同，因此所有更改都会在所有连接的客户端上实时反映出来。

MCP服务器包装 atem-connection 方法作为Claude（或任何兼容MCP的AI）可以调用的MCP工具。每个工具映射到一个或多个ATEM命令。

运输方式：

• 标准 （默认）--适用于Claude Desktop、Cursor和本地MCP客户端
• 超文本传输协议 (TRANSPORT=http)--使用OAuth 2.0的流式HTTP，用于claude.ai、claude Mobile和远程访问。使用快捷+原始 http.createServer 以便使用MCP SDK进行正确的标头处理。

直播节目使用情况

在现场生产期间使用此服务器控制ATEM时，您需要立即执行每个命令——没有确认对话框，没有批准提示，没有延迟。体验因客户而异：

客户行为

对于现场制作，请使用claude.ai、claude Mobile或claude Desktop。 这些客户端执行MCP工具调用时不会中断——你说 *“切换到相机2”* 并且它立即发生。

Claude Code（终端CLI）专为软件开发而设计，并具有在运行工具之前提示批准的安全系统。这非常适合编码，但不适合每秒都很重要的实时切换。

展前检查表

在上线之前，先浏览一下这份清单，以便及早发现问题：

1. 验证连接 — *“显示切换器状态”*
2. 测试切换 — *将相机1置于预览模式，然后切换到该模式*
3. 测试转换 — *“将过渡设置为在30帧时混合，并溶解到相机2”*
4. 测试音频 — *“显示混音器状态”*
5. 测试记录/流媒体 — *“开始录制”* → 验证→ *“停止录制”*
6. 测试超级源 （如果使用）-- *“与摄像头1和2并排设置”*
7. 设置您的节目默认设置 --过渡风格、速率、音频级别、EQ预设

现场制作技巧

• 集 ATEM_HOST 在您的环境中，服务器在启动时会自动连接，无需每次手动连接
• 使用特定语言 — *“切换到相机3”* 比 *“你能换到第三台相机吗？”*
• 组合命令 — *“将相机2置于预览状态并将其溶解”* 作为单个执行 preview_and_auto 呼叫
• 保留后备方案 --在网络出现问题时，始终提供ATEM软件控制或硬件面板

故障排除

锤子图标未显示在Claude Desktop中：

• 确保您使用的是完整路径 node （奔跑 which node)
• 检查日志： ~/Library/Logs/Claude/mcp*.log
• 完全重新启动Claude Desktop（退出，而不仅仅是关闭窗口）

无法连接到ATEM：

• 验证ATEM是否在同一网络上
• 尝试从终端ping ATEM IP
• 默认ATEM端口为9910（UDP）
• 确保ATEM软件控制没有阻塞连接

claude.ai连接器显示身份验证错误：

• 检查Cloudflare“阻止AI训练机器人”是否设置为“不阻止”（请参阅 Cloudflare部分)
• 检查 安全>分析>事件 在Cloudflare仪表板中显示被阻止的请求
• 验证 BASE_URL 与您的公共隧道URL完全匹配
• 测试用 curl -X POST https://your-url/mcp --应该返回401 JSON（而不是403 HTML）

HTTP服务器返回406 Not Acceptable：

• MCP SDK需要 Accept: application/json, text/event-stream 但有些客户发送 Accept: */*
• 服务器包含一个内置的解决方法，可以在原始HTTP级别修补Accept标头

命令不起作用：

• 某些功能需要特定的ATEM型号（例如，在Mini Pro+上进行流式传输/录制）
• 检查 atem_get_status 验证连接

学分

• 盖伊·科克伦 (全球办公时间)--创建者和项目负责人
• 克劳德 通过 Anthropic --AI结对编程伙伴

• atem连接 通过 挪威广播公司 --ATEM协议库
• MCP TypeScript SDK 通过 Anthropic

许可证

麻省理工学院