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