camsnap mcp
MCP(模型上下文协议)服务器 快照 --直接从Claude Desktop、Cursor或任何兼容MCP的客户端控制和分析您的IP/RTSP摄像机。
注: 此MCP服务器是围绕 快照 项目。
______________________________________________________________________
存储库结构
camsnap-mcp/
├── pyproject.toml
└── src/
└── camsnap_mcp/
├── __init__.py
└── server.py______________________________________________________________________
先决条件
在使用此MCP服务器之前,您必须 camsnap 在您的系统上安装和配置。
- 安装凸轮卡扣:按照以下说明操作 steipete/camsnap 安装二进制文件及其依赖项(如FFmpeg)。
- 配置摄像头:确保您有一个有效的配置文件。默认情况下,
camsnap在里面找$XDG_CONFIG_HOME/camsnap/config.yaml或~/.camsnap.yaml。您可以通过运行以下命令来验证您的设置camsnap list在你的终端。
自定义配置和温度路径
CAMSNAP_CONFIG:如果您的配置文件位于非标准位置,则可以使用此环境变量指定它。CAMSNAP_TMP_DIR:默认情况下,MCP将本地文件(快照、剪辑)保存到~/.camsnap/tmp。如果您的MCP客户端在受限沙盒中运行,请使用此选项覆盖路径。CAMSNAP_RESIZE_MAX:将其设置为像素值(例如。,1024或768)自动调整捕获的快照大小。这有助于减少LLM提示中的令牌使用,同时保持足够的分析细节。如果未设置,则返回原始图像大小。
______________________________________________________________________
安装
将以下内容添加到MCP客户端配置中(例如。, claude_desktop_config.json):
{
"mcpServers": {
"camsnap": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/mamorett/mcp_camsnap.git",
"mcp-camsnap"
],
"env": {
"CAMSNAP_CONFIG": "/path/to/your/camsnap.yaml",
"CAMSNAP_TMP_DIR": "/path/to/a/safe/tmp/dir",
"CAMSNAP_RESIZE_MAX": "1024"
}
}
}
}uvx将自动下载并隔离Python服务器。无手册pip install必修的。
______________________________________________________________________
可用工具
此MCP服务器公开了以下工具:
| 工具 | 说明 |
|---|---|
list_cameras | 列出您配置的所有摄像头 ~/.camsnap.yaml 文件。 |
capture_snap | 从相机捕获一帧,并将其作为图像直接内联返回给客户端。 |
capture_clip | 在指定的持续时间内从相机录制短MP4视频片段 ~/.camsnap/tmp 并返回绝对文件路径。 |
______________________________________________________________________
本地开发
如果要在本地运行或修改服务器:
git clone https://github.com/mamorett/mcp_camsnap
cd mcp_camsnap
pip install -e "."
mcp-camsnap