Opensentry MCP

🚀 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
}

OpenCodeの設定

~/.config/opencode/opencode.jsoncに以下を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opensentry": {
      "type": "local",
      "command": ["uv", "--directory", "/path/to/OpenSentry-MCP", "run", "python", "-m", "opensentry_mcp"],
      "enabled": true,
      "environment": {
        "OPENSENTRY_URL": "https://localhost:5000",
        "OPENSENTRY_USERNAME": "admin",
        "OPENSENTRY_PASSWORD": "your_password"
      }
    }
  }
}

Claude Codeの設定

~/.claude/mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "opensentry": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/OpenSentry-MCP",
        "run",
        "python",
        "-m", "opensentry_mcp"
      ],
      "env": {
        "OPENSENTRY_URL": "https://localhost:5000",
        "OPENSENTRY_USERNAME": "admin",
        "OPENSENTRY_PASSWORD": "your_password"
      }
    }
  }
}

基本的な使用法

AIアシスタントに接続した後、以下のような質問をすることができます。

基本クエリ

• "私が持っているカメラは何で、どれがオンラインですか？"
• "過去24時間のすべての動きアラートを表示してください"
• "今日のセキュリティの概要を教えてください"
• "私のすべてのカメラが正常に動作していますか？"

アクティビティ分析

• "私が外出している間に何が起こりましたか？"
• "今朝のすべての動きアラートを表示してください"
• "今日最も多くのアクティビティを検出したカメラはどれですか？"

分析（動きノード付き）

• "動きが発生している場所のヒートマップを表示してください"
• "1日のうちで最もアクティビティが多い時間はいつですか？"
• "カメラの視野のどの領域で最も多くの動きがありますか？"
• "検出の時間別内訳を表示してください"

領域認識クエリ（動きノード付き）

• "フレーム内のどこで動きが検出されましたか？"
• "カメラの視野のどの領域で最も多くのアクティビティがありますか？"
• "フレームの左側で動きがあるアラートを表示してください"

📚 ドキュメント

リソース

プロンプト

一般的なクエリ用の事前構築されたプロンプトテンプレートです。

• 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

• 初期リリース
• カメラの一覧表示と状態
• アラート照会（動き、顔、物体）
• 録画とスナップショット
• システムの健全性と設定
• 監査ログ