Safie API MCP Server

by SafiePublic

261 downloads
Not rated
GitHub

About

MCP server that enables AI Agents to use images and events from Safie camera devices

Details

Author
SafiePublic
Downloads
261
Categories
Developer Tools, AI

- List devices registered on the Safie platform.
- Capture an image from a specified device.
- List recorded video media for a device.
- Get the current GPS location of a device.
- Retrieve the latest thumbnail for a device.
- List standard event information for a device.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Safie API MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Requires Python 3.10+ with uv or Docker. Set either the ACCESS_TOKEN environment variable (OAuth2 access token) or API_KEY (API key). Configure in Claude Desktop by adding the server to mcpServers in the client settings, using either uv run or a Docker image built from the repository.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "safie api mcp server": {
            "safie-api-mcp-server": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "safie-api-mcp-server",
                    "."
                ]
            }
        }
    }
}

McpServers

{
    "safie-api-mcp-server": {
        "command": "docker",
        "args": [
            "build",
            "-t",
            "safie-api-mcp-server",
            "."
        ]
    }
}

Safie API MCP Server

Safie APIを利用してデバイスの情報取得や操作を行うためのMCP (Model Context Protocol) サーバ

> [!NOTE]
> 本実装はプレビュー版であり一部の機能のみを試験的に提供しています。 サポート対象外となりますのでご了承の上、お使いください。

Requirements

- Python 3.10+, uv or docker

Features

Tools

- list_devices - デバイス一覧を取得します - get_device_image - 指定されたデバイスから画像を取得します - list_device_media - 指定されたデバイスで録画されている映像(メディア)の一覧を取得します - get_device_location - 指定されたデバイスの現在のGPS位置情報を取得します - get_device_thumbnail - 指定されたデバイスの最新サムネイルを取得します - list_device_standard_events - 指定されたデバイスの標準イベント情報一覧を取得します

Configuration

以下の環境変数のどちらかが設定されている必要があります

- ACCESS_TOKEN: Safie Developers OAuth2認証アプリケーションで発行したOAuth2アクセストークン
- API_KEY: Safie Developers APIキー認証アプリケーションで発行したAPIキー

両方指定した場合、ACCESS_TOKEN が利用されます

Usage

With Claude Desktop

Using python/uv

Python 3.10+, uvが手元にインストールされている場合は以下の設定を追加することで利用できます

{
  "mcpServers": {
    "Safie API": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://git@github.com/SafiePublic/safie-api-mcp-server.git",
        "safie-api-mcp-server"
      ],
      "env": {
        "ACCESS_TOKEN": ""
      }
    }
  }
}

Using docker

Dockerを用いて利用する場合は、まず以下のようにイメージをビルドします

$ docker build -t safie-api-mcp-server .

その後、以下の設定を追加することで利用できます

{
"mcpServers": {
"Safie API": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ACCESS_TOKEN",
"-e",
"API_KEY",
"safie-api-mcp-server"
],
"env": {
"ACCESS_TOKEN": ""
}
}
}
}

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.