使用说明

项目简介

Cumulocity MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它充当 LLM 客户端和 Cumulocity IoT 平台之间的桥梁。通过此服务器，LLM 能够以标准化的方式访问和操作 Cumulocity 平台上的设备、遥测数据和告警信息，从而实现更智能的物联网应用集成。

主要功能点

设备管理: 提供工具检索和过滤 Cumulocity 平台上的设备，包括按类型、名称查找设备，获取设备详情、子设备以及设备配置信息。
遥测数据访问: 允许 LLM 客户端获取设备的实时和历史遥测数据，支持按时间范围查询，帮助 LLM 理解设备状态和环境参数。
告警监控: 提供监控 Cumulocity 平台中激活告警的功能，LLM 可以根据告警的严重程度进行筛选，及时掌握系统异常和潜在问题。

安装步骤

安装 Python 包: 使用 pip 命令安装 'mcp-server-c8y' 包。

pip install mcp-server-c8y

服务器配置

MCP 服务器需要配置 Cumulocity 平台的连接信息才能正常工作。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例，用于配置 Cumulocity MCP Server。

"mcpServers": {
  "cumulocity": {  //  服务器名称，可以自定义
    "command": "python",
    "args": ["-m", "mcp_server_c8y"], //  MCP 服务器启动命令
      "env": {
        "C8Y_BASE_URL": "https://your-cumulocity-instance.com",  //  您的 Cumulocity 实例 URL，例如：https://your-tenant.cumulocity.com
        "C8Y_TENANT_ID": "your-tenant-id",  //  您的 Cumulocity 租户 ID
        "C8Y_USERNAME": "your-username",  //  您的 Cumulocity 用户名
        "C8Y_PASSWORD": "your-password"   //  您的 Cumulocity 密码
      }
  }
}

配置参数说明:

'server name': 'cumulocity'，自定义服务器名称，在客户端中用于识别和调用。
'command': 'python'，启动 MCP 服务器的命令解释器。
'args': '["-m", "mcp_server_c8y"]'，运行 'mcp_server_c8y' 模块作为服务器。
'env': 环境变量配置，用于传递 Cumulocity 连接信息。
- 'C8Y_BASE_URL': Cumulocity 实例的基础 URL。
- 'C8Y_TENANT_ID': Cumulocity 租户 ID。
- 'C8Y_USERNAME': Cumulocity 用户名。
- 'C8Y_PASSWORD': Cumulocity 密码。

请将 'C8Y_BASE_URL', 'C8Y_TENANT_ID', 'C8Y_USERNAME', 'C8Y_PASSWORD' 替换为您的实际 Cumulocity 平台信息。

基本使用方法

启动 Claude Desktop 或其他 MCP 客户端。
客户端成功连接到 Cumulocity MCP Server 后，您可以在客户端的工具菜单中看到 Cumulocity 相关的工具，例如获取设备列表、获取设备遥测数据、查看激活告警等。
在 LLM 对话中，您可以指示 LLM 使用这些工具来查询和分析 Cumulocity 平台的数据，从而实现基于物联网数据的智能应用。

例如，您可以指示 LLM “列出所有温度超过 30 度的设备” 或者 “获取设备 ID 为 ‘device123’ 的最新遥测数据”。LLM 将会调用 Cumulocity MCP Server 提供的工具来执行这些操作，并将结果返回给您。

关键词