Opensentry MCP

🚀 OpenSentry MCP Server

OpenSentry MCP Server 是 OpenSentry 指揮中心的只讀 MCP 服務器。它允許像 OpenCode 和 Claude Code 這樣的 AI 助手通過標準化的 MCP 接口查詢攝像頭狀態、帶有位置數據的檢測警報、錄像以及系統健康狀況。

✨ 主要特性

運動區域數據

警報包含運動區域座標，使 AI 無需視覺能力就能瞭解畫面中活動發生的位置：

🚶 [2026-01-22T08:13:09] camera_name: motion (0.0% confidence) at (560, 333) size=29x32

• 區域：{x, y, width, height} - 檢測到的運動的邊界框
• AI 可以推斷："在畫面的右上角區域檢測到運動"
• 對模式分析和位置感知查詢很有用

🚀 快速開始

git clone https://github.com/SourceBox-LLC/OpenSentry-MCP.git
cd OpenSentry-MCP
./setup.sh
# 按照提示輸入你的 OpenSentry URL 和管理員憑據

然後啟動服務器：

source .venv/bin/activate
uv run python -m opensentry_mcp

📦 安裝指南

手動安裝

# 克隆倉庫
git clone https://github.com/SourceBox-LLC/OpenSentry-MCP.git
cd OpenSentry-MCP

# 如果你沒有安裝 uv，安裝它
curl -LsSf https://astral.sh/uv/install.sh | sh

# 創建虛擬環境並安裝依賴
uv venv
source .venv/bin/activate  # 在 Windows 上使用 .venv\Scripts\activate
uv sync

配置

創建一個 .env 文件或設置環境變量：

OPENSENTRY_URL=https://localhost:5000
OPENSENTRY_USERNAME=admin
OPENSENTRY_PASSWORD=your_password

從你的指揮中心的 設置 > 用戶管理 中獲取憑據。

運行

# 使用 stdio 傳輸運行（默認，適用於 Claude Desktop/OpenCode）
uv run python -m opensentry_mcp

# 使用 HTTP 傳輸運行
uv run python -m opensentry_mcp --transport http --port 8000

💻 使用示例

可用工具

警報數據格式

每個警報包含：

{
  "id": 872,
  "camera_id": "driveway",
  "type": "motion",
  "confidence": 0.0,
  "region": {
    "x": 280,
    "y": 279,
    "width": 18,
    "height": 45
  },
  "timestamp": "2026-01-22T08:02:21.152631",
  "processed": false
}

與 AI 助手連接後的查詢示例

基礎查詢

• "我有哪些攝像頭，哪些是在線的？"
• "給我展示過去 24 小時的所有運動警報"
• "給我今天的安全摘要"
• "我的所有攝像頭是否都正常工作？"

活動分析

• "我不在的時候發生了什麼？"
• "給我展示今天早上的所有運動警報"
• "哪個攝像頭今天檢測到的活動最多？"

分析（使用運動節點）

• "給我展示運動發生位置的熱力圖"
• "一天中活動最繁忙的時間是什麼時候？"
• "我的攝像頭視野中哪些區域運動最多？"
• "給我展示檢測的每小時細分情況"

區域感知查詢（使用運動節點）

• "畫面中哪裡檢測到了運動？"
• "攝像頭視野的哪些區域活動最多？"
• "給我展示畫面左側有運動的警報"

📚 詳細文檔

資源

預構建提示模板

• daily_security_summary - 生成每日安全報告
• what_happened_while_i_was_away - 總結不在期間的活動
• camera_activity_report - 每個攝像頭的活動細分

🔧 技術細節

開發

# 安裝開發依賴
uv sync --extra dev

# 熱重載運行（需要 mcp[cli]）
mcp dev src/opensentry_mcp/server.py

# 運行測試
uv run pytest

要求

• Python 3.10+
• uv（包管理器）
• 可訪問運行中的 OpenSentry 指揮中心
• 指揮中心的管理員憑據

項目結構

opensentry-mcp/
├── setup.sh              # 快速設置腳本
├── pyproject.toml        # 項目配置（uv）
├── README.md             # 本文件
├── .env.example          # 環境模板
├── .venv/                # 虛擬環境
└── src/opensentry_mcp/
    ├── __init__.py       # 包導出
    ├── __main__.py       # 入口點
    ├── client.py         # OpenSentry API 客戶端
    └── server.py         # 帶有工具的 FastMCP 服務器

更新日誌

v0.3.0

• 新增 get_motion_hotspots() - 運動檢測位置的熱力圖分析
• 新增 get_activity_timeline() - 隨時間的每小時/每日檢測模式
• 基於網格的熱點分析將畫面劃分為可配置的單元格（默認 10x10）
• 時間線顯示按時間間隔的檢測頻率

v0.2.0

• 警報中添加運動區域/邊界框數據
• AI 現在可以瞭解畫面中運動發生的位置
• 簡化警報工具（移除包裝函數）
• 更新顯示格式以顯示區域座標

v0.1.0

• 初始版本
• 攝像頭列表和狀態
• 警報查詢（運動、人臉、物體）
• 錄像和快照
• 系統健康和設置
• 審計日誌