Cameracontroller

by JackGao19700

2 stars

290 downloads

Not rated

GitHub

Other

About

Cameracontroller is a multi‑protocol camera control service built on Node.js/TypeScript that follows the Model Context Protocol (MCP). It enables AI assistants to enumerate cameras, capture photos, record videos, and start live video streams on Windows and Linux.

Details

Author: JackGao19700
GitHub stars: 2
Downloads: 290
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Cameracontroller

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

From the repository

Install via npm install, copy .env.sample to .env, configure environment variables, build with npm run build, then start with npm start (or npm run start:http for HTTP/SSE mode). For testing, use npm link and connect with the MCP Inspector using STDIO transport.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cameracontroller": {
            "mcp-camera-service": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-camera-service",
                    "stdio"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-camera-service": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-camera-service",
            "stdio"
        ]
    }
}

MCP Camera Service

功能简介

本项目是基于 Node.js/TypeScript 的多协议摄像头控制服务，严格遵循 Model Context Protocol (MCP) TypeScript SDK，支持：
- 摄像头枚举、拍照、录像（文件/推流）等能力
- MCP 工具接口（listCameras、takePhoto、startVideo、stopVideo）
- 多种传输模式：stdio、HTTP、SSE
- 支持 Windows（dshow）和 Linux（v4l2）
- 支持多实例并发录像、推流
- 丰富的环境变量配置，日志可定制
- 录像推流支持 streamUrl，客户端可用 httpx/curl/ffmpeg/ffplay 拉流

---

环境依赖

- Node.js 16+ - ffmpeg（需已安装并在 PATH 或通过 ffmpeg-static 提供） - 推荐 Windows 10+/Linux，需有摄像头设备

---

安装与启动

npm install
配置 .env 文件（见下文）
npm run build
npm start # 或 npm run start:http

---

.env 配置说明

在您的本地执行时,请将.env.sample复制为.env,然后配置为您需求的参数.

# HTTP 服务端口
PORT=3001
MCP 服务名/版本
MCP_SERVER_NAME=mcp-camera-server
MCP_SERVER_VERSION=1.0.0
日志等级与文件
LOG_LEVEL=info
LOG_FILEPATH=./camera.log
拍照/录像文件前缀与目录
PHOTO_PREFIX=image
VIDEO_PREFIX=video
PHOTO_DIR=photos
VIDEO_DIR=videos
录像上下文自动清理时间（秒）
FINISHED_VIDEO_CLEAN_SPAN_SECOND=1800
推流URL超时时间（毫秒）
STREAM_URL_EXPIRE_MS=300000

---

主要 MCP 工具接口

1. listCameras - 枚举摄像头

功能说明: 列出所有可用的摄像头设备

输入参数: 无

输出参数:
- cameras: 摄像头列表
- cameraID: 摄像头编号
- name: 设备名称
- description: 设备描述

2. takePhoto - 拍照功能

功能说明: 从指定摄像头拍摄照片并保存

输入参数:
- cameraID: 摄像头编号
- filepath: 照片保存目录路径

输出参数:
- success: 操作是否成功
- imagePath: 照片保存路径(成功时返回)
- error: 错误信息(失败时返回)

3. startVideo - 开始录像/推流

功能说明: 启动视频录制或实时推流

输入参数:
- cameraID: 摄像头编号
- filepath: 录像文件保存路径(可选，不传则启动推流模式)
- duration: 录像时长(毫秒，可选)

输出参数(文件模式):
- success: 操作是否成功
- videoPath: 视频文件路径
- videoID: 录像会话ID

输出参数(推流模式):
- success: 操作是否成功
- videoID: 录像会话ID
- streamUrl: 推流访问地址

4. stopVideo - 停止录像/推流

功能说明: 停止正在进行的录像或推流

输入参数:
- videoID: 录像会话ID(startVideo返回)

输出参数:
- success: 操作是否成功
- message: 操作结果消息
- videoPath: 视频文件路径(文件模式时存在)
- error: 错误信息(失败时返回)

---

MCP 工具接口测试方法

- 下载本仓库后,进入仓库根目录cd myCameraNodejs - 使用npm link . 链接为全局命令 - 请通过npx modelcontextprotocol/inspector启动modelcontextprotocol/inspector进行测试：

在界面中:
- Transport Type: 选择STDIO
- Command: 选择npx
- Arguments: 输入mcp-camera-server

点击Connect按钮，即可连接到摄像头服务。
如果通过npx run start:sse启动服务，URL填入http://127.0.0.1:3001/sse(注意3001由.env中PORT指定)

视频流测试方法

1. 用 curl 保存为 ts 文件

curl http://localhost:3001/video/stream?videoID=xxxx-xxxx-xxxx -o output.ts

2. 用 ffplay 直接播放

ffplay http://localhost:3001/video/stream?videoID=xxxx-xxxx-xxxx

3. 用 ffmpeg 保存为 mp4 文件

直接转码为 mp4（推荐）

ffmpeg -i "http://localhost:3001/video/stream?videoID=xxxx-xxxx-xxxx" -c:v libx264 -preset veryfast -crf 23 -f mp4 output.mp4

只保存为 ts 文件（无需转码，最快）

ffmpeg -i "http://localhost:3001/video/stream?videoID=xxxx-xxxx-xxxx" -c copy output.ts

---

常见问题与排查

- ffplay/ffmpeg 报 Invalid data found when processing input
- 请确认服务端推流格式为 mpegts（已修正）
- streamUrl 只能消费一次/超时失效
- 设计如此，需重新调用 startVideo 获取新 streamUrl
- 摄像头找不到/拍照失败
- 请先用 listCameras 获取 cameraID，确保 ffmpeg 能识别
- 录像文件无法播放
- 建议用 ffmpeg/ffplay 转码或播放
- 推流超时时间/录像上下文清理时间
- 可通过 .env 配置 STREAM_URL_EXPIRE_MS、FINISHED_VIDEO_CLEAN_SPAN_SECOND

---

其它说明

- 支持多实例并发录像/推流 - 日志详尽，便于排查 - 支持 Windows/Linux，自动适配 dshow/v4l2 - 支持 MCP stdio/http/sse 多种模式

如有更多问题或需求，欢迎 issue 或联系Jackgao19700@qq.com or gaoshengqiang19700@gmail.com

it is certified by MCPHub. You can get it from https://mcphub.com/mcp-servers/jackgao19700/cameramcpserver.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

MCP Camera Service

功能简介

环境依赖

安装与启动

配置 .env 文件（见下文）

.env 配置说明

MCP 服务名/版本

日志等级与文件

拍照/录像文件前缀与目录

录像上下文自动清理时间（秒）

推流URL超时时间（毫秒）

主要 MCP 工具接口

1. listCameras - 枚举摄像头

2. takePhoto - 拍照功能

3. startVideo - 开始录像/推流

4. stopVideo - 停止录像/推流

MCP 工具接口测试方法

视频流测试方法

1. 用 curl 保存为 ts 文件

2. 用 ffplay 直接播放

3. 用 ffmpeg 保存为 mp4 文件

直接转码为 mp4（推荐）

只保存为 ts 文件（无需转码，最快）

常见问题与排查

其它说明

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀