Cumulocity MCP Server

Name: Cumulocity MCP Server
Author: Cumulocity-IoT

@Cumulocity-IoT

关于 Cumulocity MCP Server

A Python-based server that provides Cumulocity IoT platform functionality through the MCP (Model Control Protocol) interface.

基本信息

分类

其他

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

Cumulocity-IoT

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "cumulocity-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_c8y"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Cumulocity MCP Server?

A Python-based server that provides Cumulocity IoT platform functionality through the MCP (Model Control Protocol) interface. It enables seamless interaction with Cumulocity’s device management, measurements, and alarm systems for administrators and developers.

How to use Cumulocity MCP Server?

Install via pip install mcp-server-c8y or use uvx mcp-server-c8y. Configure environment variables (C8Y_BASEURL, C8Y_TENANT, C8Y_USER, C8Y_PASSWORD) and connect clients like Claude Desktop or Cursor. For deployment on a Cumulocity tenant, build a microservice deployment package using the provided script and upload it via the Cumulocity Administration UI.

Key features of Cumulocity MCP Server

List and filter devices with pagination options
Retrieve detailed device, child device, and fragment data
Fetch device measurements with ISO 8601 time filtering
Monitor active alarms filtered by severity
Evaluate JSONata expressions against JSON objects

Use cases of Cumulocity MCP Server

Query and filter devices in a Cumulocity instance from an MCP‑compatible client
Retrieve time‑bounded measurements for specific devices for analysis
Monitor and filter active alarms by severity level for incident response
Integrate Cumulocity data into AI assistants (e.g., Claude Desktop) for natural‑language queries

FAQ from Cumulocity MCP Server

How do I install Cumulocity MCP Server?

Use pip install mcp-server-c8y or run directly with uvx mcp-server-c8y. After installing, execute python -m mcp_server_c8y.

What environment variables are required for authentication?

Set C8Y_BASEURL, C8Y_TENANT, C8Y_USER, and C8Y_PASSWORD for stdio transport. For HTTP transport (e.g., Cursor), use a url and Authorization header with Base64‑encoded credentials.

Can Cumulocity MCP Server be deployed directly on the Cumulocity platform?

Yes. Build a microservice deployment package using ./scripts/buildcontainer.sh, which creates mcp-server-c8y.zip, then upload it via Administration > Ecosystem > Microservices in your Cumulocity tenant.

What transport methods are supported?

The server supports stdio transport (used with Claude Desktop via uvx) and HTTP/SSE transport (used when deployed as a microservice, e.g., https://<tenant>.cumulocity.com/service/mcp-server-c8y/mcp/).

What tools are available in Cumulocity MCP Server?

It provides tools for device management (Get Devices, Get Device by ID, Get Child Devices, Get Device Fragments), measurements (Get Device Measurements), alarms (Get Active Alarms), and a dynamic mapper (evaluate_jsonata_expression).