Cameramcpserver
What is Cameramcpserver
CameraMCPServer is a multi-protocol camera control service built on Node.js and TypeScript, strictly adhering to the Model Context Protocol (MCP). It enables functionalities such as camera enumeration, photo capturing, and video recording (both file and streaming).
Use cases
Use cases for CameraMCPServer include automating photo capture for security monitoring, live streaming video for events, recording video for content creation, and integrating camera functionalities into custom applications.
How to use
To use CameraMCPServer, install the necessary dependencies using ‘npm install’, configure the ‘.env’ file according to your requirements, build the project with ‘npm run build’, and start the server using ‘npm start’ or ‘npm run start:http’.
Key features
Key features include camera enumeration, photo capture, video recording and streaming, support for multiple transport modes (stdio, HTTP, SSE), multi-instance concurrent recording, extensive environment variable configuration, and customizable logging.
Where to use
CameraMCPServer can be utilized in various fields such as surveillance systems, video conferencing applications, media production, and any application requiring camera control and management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Cameramcpserver
CameraMCPServer is a multi-protocol camera control service built on Node.js and TypeScript, strictly adhering to the Model Context Protocol (MCP). It enables functionalities such as camera enumeration, photo capturing, and video recording (both file and streaming).
Use cases
Use cases for CameraMCPServer include automating photo capture for security monitoring, live streaming video for events, recording video for content creation, and integrating camera functionalities into custom applications.
How to use
To use CameraMCPServer, install the necessary dependencies using ‘npm install’, configure the ‘.env’ file according to your requirements, build the project with ‘npm run build’, and start the server using ‘npm start’ or ‘npm run start:http’.
Key features
Key features include camera enumeration, photo capture, video recording and streaming, support for multiple transport modes (stdio, HTTP, SSE), multi-instance concurrent recording, extensive environment variable configuration, and customizable logging.
Where to use
CameraMCPServer can be utilized in various fields such as surveillance systems, video conferencing applications, media production, and any application requiring camera control and management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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: 选择STDIOCommand: 选择npxArguments: 输入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 或联系[email protected]。
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
