Safie Api MCP Server

🚀 Safie API MCP サーバ

Safie API を利用してデバイスの情報取得や操作を行うための MCP (モデル コンテキスト プロトコル) サーバです。このサーバを使うことで、Safie API を通じてデバイスの管理やデータの取得が可能になります。

🚀 クイックスタート

このサーバを使用する前に、いくつかの前提条件を満たす必要があります。また、設定方法や使用方法についても説明します。

✨ 主な機能

ツール

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

📦 インストール

要求事項

• Python 3.10+、uv または Docker

🔧 設定

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

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

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

💻 使用例

Claude Desktop での使用

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": "******"
      }
    }
  }
}

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": "******"
      }
    }
  }
}

⚠️ 重要提示

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