OBSBOT Tiny 2 Camera Control — Claude Code MCP server
OBSBOT Tiny 2 Camera Control is a Claude Code MCP server that manages OBSBOT Tiny 2 cameras over USB. It handles PTZ gimbal rotation, zoom levels, and focus.
MIT ★ 6 updated 2026-11-05
claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcpWhat OBSBOT Tiny 2 Camera Control does
The server links an assistant to OBSBOT Tiny 2 hardware over standard UVC/USB connections. Vendor SDKs are not required. It also interfaces with OBSBOT Tail 2 network cameras through HTTP and WebSockets. Agents receive 35 control tools on Windows and macOS for pan, tilt, zoom, autofocus, and frame capture. Launching with --debug adds the low-level probe tool obsbot_debug_probe.
When multiple cameras are connected, obsbot_devices scans their serial numbers and availability states. Individual actions accept a camera serial argument. The obsbot_aim_at_pixel tool centers the lens on designated pixel coordinates directly from an acquired frame.
Linux environments carry distinct restrictions. The obsbot_gimbal_move_speed action is disabled, and obsbot_gimbal_position reports the last commanded angle rather than live telemetry.
What it helps with
- adjust gimbal pan, tilt, and roll angles
- center the camera view onto specific image pixel coordinates
- inspect live zoom, focus, and exposure parameters
- switch the hardware between awake and sleep positions
Example prompts for the agent
- Pan the camera 20 degrees left and tilt down by 10 degrees
- Check the camera status and report the current zoom percent
- Put the camera into sleep mode
How to install OBSBOT Tiny 2 Camera Control
Platform CLI
claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcpReplace <…> with your own values
Platform CLI
codex mcp add obsbot-tiny-2-camera-control --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> -- npx -y obsbot-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"obsbot-tiny-2-camera-control": {
"command": "npx",
"args": [
"-y",
"obsbot-mcp"
],
"env": {
"OBSBOT_LOG_FILE": "<OBSBOT_LOG_FILE>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"obsbot-tiny-2-camera-control": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obsbot-mcp"
],
"env": {
"OBSBOT_LOG_FILE": "<OBSBOT_LOG_FILE>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> obsbot-tiny-2-camera-control npx -y obsbot-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OBSBOT Tiny 2 Camera Control
How do I install OBSBOT Tiny 2 Camera Control in Claude Code?
Run claude mcp add obsbot-mcp -- npx -y obsbot-mcp. If file logging is required, pass the environment variable: claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcp.
What does OBSBOT Tiny 2 Camera Control do?
It provides tools to direct pan, tilt, zoom, autofocus, and power modes on OBSBOT Tiny 2 cameras via USB and OBSBOT Tail 2 over HTTP.
What limitations apply on Linux systems?
The speed movement tool obsbot_gimbal_move_speed is unavailable on Linux. In addition, obsbot_gimbal_position returns the last commanded angle rather than real-time hardware position telemetry.