Cumulocity MCP Server

Example Use Cases

• 1

  Query and filter devices (by type or name), retrieve device details, and explore device fragments programmatically.

• 2

  Fetch time-range filtered measurements from devices and page through measurement results for analytics or monitoring.

• 3

  Monitor active alarms by severity and integrate alarm data into workflows or dashboards, including deployment as a Cumulocity microservice.

Description

This project implements a Python-based MCP (Model Control Protocol) server that lets agents interact with Cumulocity IoT features such as device management, measurements, and alarms. It provides endpoints to list and filter devices, retrieve device details and fragments, fetch time-filtered measurements, and monitor active alarms. The server supports deployment as a Cumulocity microservice and can be run locally (pip or uvx) and integrated with tools like Claude Desktop. It also includes a dynamic mapper utility for evaluating JSONata expressions against JSON payloads.