使用说明
物理mcp
给你的AI眼睛。
物理mcp 是一个开源 主控程序 提供任何AI实时摄像头视觉的服务器。 获取警报 WhatsApp、Telegram、Discord、Slack、Signal --或者和你的人工智能谈谈它看到了什么。
“看着我的前门,有人来的时候告诉我” ->你的AI透过摄像头看到并在WhatsApp/Telegram/Discord/Slack上提醒你
快速开始
1.安装OpenClaw+物理mcp
npm install -g openclaw
pip install physical-mcp
2.连接您的聊天应用
openclaw configure
连接WhatsApp、Telegram、Discord、Slack或Signal——无论您已经使用过哪种。
3.启动摄像头
physical-mcp
安装向导检测到您的摄像头并启动视觉服务器。
4.与你的AI对话
打开任何连接的聊天应用程序,告诉你的AI要注意什么:
- “看着我的前门,有人来的时候提醒我”
- “告诉我,如果我的孩子离开房间”
- “当我向相机挥手时,说‘你好!’”
- “监控炉子,如果有什么东西在燃烧,就警告我”
你的人工智能可以透过摄像头看到,理解场景,并通过你已经使用的聊天应用程序向你发送警报。没有要安装的新应用程序。
运作原理
You (WhatsApp/Telegram/Discord/Slack)
|
v
OpenClaw (routes messages to your AI)
|
v
physical-mcp (camera vision + watch rules)
|
v
Your camera (laptop, USB, IP/RTSP)
- 你聊天 在WhatsApp、Telegram、Discord或Slack中使用您的AI
- 开爪 将你的信息路由到人工智能,并将物理mcp作为一种技能连接起来
- 物理mcp 捕捉相机帧,使用视觉AI分析场景,并评估观看规则
- 火警警报 满足条件后返回聊天应用程序
特性
- 任何相机 --笔记本电脑网络摄像头、USB、RTSP/HTTP IP摄像头
- 任何AI --Claude桌面、ChatGPT、游标、VS代码、Gemini(通过MCP协议)
- 任何信使 --WhatsApp、Telegram、Discord、Slack、Signal(通过OpenClaw)
- 自定义警报 --“当我做X形时,说‘不可能!’”
- 全天候视野 --本地变化检测(<5ms),仅在发生变化时调用AI(~5美元/月)
- 14个规则模板 --人员检测、包裹递送、宠物监测、婴儿监测等
- Web仪表板 --实时摄像头馈送、场景分析、警报
localhost:8090/dashboard - 云就绪 --部署到Fly.io或Docker,支持远程摄像头
- 506测试 --经过彻底测试,获得麻省理工学院许可
独立设置
物理mcp也可以直接与mcp兼容的AI应用程序配合使用——不需要OpenClaw:
- 克劳德桌面快速入门
- ChatGPT快速入门
- 光标快速启动
- VS代码快速入门
- Gemini快速入门
- OpenClaw快速入门
- Windsurf快速入门
- 带来快速启动
- CodeBuddy快速入门
- 通用MCP客户端快速入门
平台快速启动
故障排除
独立快速安装
pip install physical-mcp
physical-mcp
对于ChatGPT HTTPS访问:
pip install 'physical-mcp[tunnel]'
physical-mcp tunnel
CLI命令
physical-mcp # setup wizard + run server
physical-mcp status # check service status
physical-mcp tunnel # expose over HTTPS (for ChatGPT)
physical-mcp doctor # run diagnostics
physical-mcp discover # scan LAN for IP cameras
physical-mcp cameras # list available cameras
physical-mcp rules # list active watch rules
physical-mcp --version # show version
一旦运行,打开 http://localhost:8090/dashboard 用于实时网络仪表板。
指南
- 安装指南 --完整演练:安装、配置、首次警报(10分钟)
- 模块参考 -所有组件的完整API参考
- 建筑 --系统如何在引擎盖下工作
- 视觉代理架构
- 平台快速启动 --Claude Desktop、ChatGPT、游标、VS代码、Gemini、Docker
贡献
请阅读 贡献.md. 使用问题模板进行错误报告和功能请求。
许可证
麻省理工学院
