# OBSBOT Tiny 2 Camera Control

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: lxman
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lxman/obsbot-mcp
- Updated: 2026-11-05
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/obsbot-tiny-2-camera-control

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OBSBOT_LOG_FILE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> --transport stdio obsbot-tiny-2-camera-control -- npx -y obsbot-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add obsbot-tiny-2-camera-control --env OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> -- npx -y obsbot-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "obsbot-tiny-2-camera-control": {
            "command": "npx",
            "args": [
                "-y",
                "obsbot-mcp"
            ],
            "env": {
                "OBSBOT_LOG_FILE": "<OBSBOT_LOG_FILE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OBSBOT_LOG_FILE=<OBSBOT_LOG_FILE> obsbot-tiny-2-camera-control npx -y obsbot-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [camsnap](https://affpapa.org/en/nevibecode/skills/camsnap.md) — skill · 5100 installs
- [mcp-tiny](https://affpapa.org/en/nevibecode/mcp/mcp-tiny.md) — MCP server · ★ 279 repo stars
- [tiny-tool-town-submitter](https://affpapa.org/en/nevibecode/plugins/tiny-tool-town-submitter.md) — plugin · ★ 41430 repo stars
- [Desktop Control](https://affpapa.org/en/nevibecode/skills/desktop-control.md) — skill · 4000 installs
- [jetson-customize-camera](https://affpapa.org/en/nevibecode/skills/jetson-customize-camera.md) — skill · 1200 installs
- [filmkit-fujifilm-camera](https://affpapa.org/en/nevibecode/skills/filmkit-fujifilm-camera.md) — skill · 932 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
