Safie API MCP Server

Name: Safie API MCP Server
Author: SafiePublic

本地服务

github.com/SafiePublic开发工具76 周前更新

代码仓库

关于 Safie API MCP Server

Safie API MCP Server 将 Safie 摄像设备信息与影像事件能力开放给 AI Agent。它提供设备列表、图像、录像媒体、位置、缩略图和标准事件查询；目前为预览版。

主要功能

01获取设备列表
02读取设备图像与缩略图
03列出录像媒体
04查询 GPS 位置
05读取标准事件

适用场景

01查看已连接的 Safie 设备
02获取摄像头图像或最新缩略图
03检查录制媒体与设备位置
04查询设备标准事件

MCP 相关

作为 MCP 服务，它向 MCP 客户端提供 Safie 设备与媒体查询工具。使用时需配置 Safie OAuth2 访问令牌或 API 密钥。

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

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "safie-api": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "build"
      ]
    }
  }
}

启动命令docker run -i --rm build

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocibuildstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Safie API MCP 服务

用于通过 Safie API 获取和操作设备信息的 MCP（Model Context Protocol）服务

说明

此实现为预览版，仅试验性地提供部分功能。此版本不在支持范围内，请知悉后再使用。

要求

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://[email protected]/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": "******"
      }
    }
  }
}

支持 Markdown

登录后评论