Safie API MCP Server

Name: Safie API MCP Server
Author: SafiePublic

@SafiePublic

Repository

About Safie API MCP Server

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

#safie-api #mcp-server #ai-agents

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

デバイス一覧を取得します

指定されたデバイスから画像を取得します

指定されたデバイスで録画されている映像（メディア）の一覧を取得します

指定されたデバイスの現在のGPS位置情報を取得します

指定されたデバイスの最新サムネイルを取得します

指定されたデバイスの標準イベント情報一覧を取得します

Overview

What is Safie API MCP Server?

An MCP (Model Context Protocol) server that uses the Safie API to retrieve device information and perform operations. It is a preview release offering experimental access to a subset of Safie device functionality.

How to use Safie API MCP Server?

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.

Key features of Safie API MCP Server

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.

Use cases of Safie API MCP Server

Querying device status and location during AI‑powered conversations.
Pulling live snapshots or recent media from surveillance cameras.
Integrating Safie device data into workflows via Claude Desktop.

FAQ from Safie API MCP Server

Is this server production‑ready?

No, this implementation is a preview version that only offers a limited set of features experimentally. It is not officially supported.

What runtime dependencies are required?

Python 3.10 or later, and either uv or Docker to run the server.

How do I authenticate with the Safie API?

Set the environment variable ACCESS_TOKEN (OAuth2 access token) or API_KEY (API key). If both are set, ACCESS_TOKEN takes precedence.

What tools are available?

Six tools: list_devices, get_device_image, list_device_media, get_device_location, get_device_thumbnail, and list_device_standard_events.

Are there any known limitations?

The server is a preview; only a subset of Safie API capabilities is exposed, and support is not provided. Data handling follows standard MCP transport (stdio) and authentication via environment variables.