MCP.so
ログイン

Cumulocity MCP Server

@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).

コメント

「その他」の他のコンテンツ