Safie Api MCP Server

🚀 Safie API MCP Server

An MCP (Model Context Protocol) server for retrieving device information and performing operations using the Safie API.

⚠️ Important Note

This implementation is a preview version and only provides some functions on a trial basis. It is not supported, so please use it at your own discretion.

🚀 Quick Start

✨ Features

Tools

• list_devices
  • Retrieve a list of devices.
• get_device_image
  • Retrieve an image from the specified device.
• list_device_media
  • Retrieve a list of videos (media) recorded by the specified device.
• get_device_location
  • Retrieve the current GPS location information of the specified device.
• get_device_thumbnail
  • Retrieve the latest thumbnail of the specified device.
• list_device_standard_events
  • Retrieve a list of standard event information for the specified device.

📦 Installation

Requirements

• Python 3.10+、uv or Docker

Configuration

One of the following environment variables must be set:

• ACCESS_TOKEN: An OAuth2 access token issued by the Safie Developers OAuth2 authentication application.
• API_KEY: An API key issued by the Safie Developers API key authentication application.

If both are specified, ACCESS_TOKEN will be used.

💻 Usage Examples

Usage with Claude Desktop

Using Python/uv

If Python 3.10+ and uv are installed, you can use it by adding the following configuration:

{
  "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

If you want to use Docker, first build the image as follows:

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

Then, you can use it by adding the following configuration:

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