safie-api-mcp-server

# Safie API MCP Server MCP (Model Context Protocol) server for retrieving and operating device information using the Safie API. > [!NOTE] > This implementation is a preview version and only provides a limited set of features for testing purposes. Please use it with this understanding, as it is not officially supported. ## Requirements - Python 3.10+, uv or docker ## Features ### Tools - list_devices - Retrieves a list of devices. - get_device_image - Retrieves an image from the specified device. - list_device_media - Retrieves a list of recorded media from the specified device. - get_device_location - Retrieves the current GPS location information of the specified device. - get_device_thumbnail - Retrieves the latest thumbnail from the specified device. - list_device_standard_events - Retrieves a list of standard event information for the specified device. ## Configuration One of the following environment variables must be set: - `ACCESS_TOKEN`: The OAuth2 access token issued by the Safie Developers OAuth2 authentication application. - `API_KEY`: The API key issued by the Safie Developers API key authentication application. If both are specified, `ACCESS_TOKEN` will be used. ## Usage ### With Claude Desktop #### Using python/uv If you have Python 3.10+ and uv installed, you can use it by adding the following configuration: ```json { "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": "******" } } } } ``` #### Using docker If you want to use it with Docker, first build the image as follows: ```shell $ docker build -t safie-api-mcp-server . ``` Then, you can use it by adding the following configuration: ```json { "mcpServers": { "Safie API": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ACCESS_TOKEN", "-e", "API_KEY", "safie-api-mcp-server" ], "env": { "ACCESS_TOKEN": "******" } } } } ```