🚀 Safie API MCP 服务器
Safie API 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。
不同方式使用配置
使用 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": "******"
}
}
}
}