Safie Api MCP Server

🚀 Safie API MCP 服務器

Safie API MCP 服務器是一個 MCP（模型上下文協議）服務器，可藉助 Safie API 獲取設備信息並對設備進行操作。

⚠️ 重要提示

本實現為預覽版，僅試驗性地提供部分功能，不提供支持，請知悉後再使用。

🚀 快速開始

要求事項

• Python 3.10+、uv 或 Docker

✨ 主要特性

工具

• list_devices
  • 獲取設備列表
• get_device_image
  • 從指定設備獲取圖像
• list_device_media
  • 獲取指定設備錄製的視頻（媒體）列表
• get_device_location
  • 獲取指定設備的當前 GPS 位置信息
• get_device_thumbnail
  • 獲取指定設備的最新縮略圖
• list_device_standard_events
  • 獲取指定設備的標準事件信息列表

📦 安裝指南

以下環境變量必須設置其中之一：

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