STARWARCLOUD STARWAR.AI
返回市场
<中文翻译> litmus-MCP服务器

<中文翻译> litmus-MCP服务器

作者：litmusautomation5 星标更新：2025-11-04
安装使用来源：spider==github.com

项目介绍

<p align="center"> <a href="https://litmus.io"> <picture> <source media="(prefers-color-scheme: light)" srcset="static/litmus-logo-light.svg" /> <source media="(prefers-color-scheme: dark)" srcset="static/litmus-logo-dark.svg" /> <img src="static/litmus-logo-light.svg" height="60" alt="Litmus logo" /> </picture> </a> </p> <p align="center"> <a href="https://docs.litmus.io"> <img src="https://img.shields.io/badge/Litmus-Docs-2acfa6?style=flat-square" alt="文档" /> </a> <a href="https://www.linkedin.com/company/litmus-automation/" > <img src="https://img.shields.io/badge/LinkedIn-关注-0a66c2?style=flat-square" alt="在LinkedIn上关注我们" /> </a> </p>

Litmus MCP 服务器

官方的 Litmus Automation 模型上下文协议 (MCP) 服务器使大型语言模型和智能系统能够与 Litmus Edge 进行设备配置、监控和管理交互。它基于 MCP SDK 构建，并遵循 模型上下文协议规范。

<div> <picture> <source media="(prefers-color-scheme: light)" srcset="static/MCP-server-arch-diagram.png" /> <img src="static/MCP-server-arch-diagram.png" alt="Litmus MCP 服务器架构图" /> </picture> </div>

目录

开始使用

快速启动 (Docker)

在 Docker 中运行服务器：

docker run -d --name litmus-mcp-server -p 8000:8000 ghcr.io/litmusautomation/litmus-mcp-server:latest

Cursor IDE 设置

示例 mcp.json 配置：

{
  "mcpServers": {
    "litmus-mcp-server": {
      "url": "http://<MCP_SERVER_IP>:8000/sse",
      "headers": {
        "EDGE_URL": "https://<LITMUSEDGE_IP>",
        "EDGE_API_CLIENT_ID": "<oauth2_client_id>",
        "EDGE_API_CLIENT_SECRET": "<oauth2_client_secret>",

        "NATS_SOURCE": "<LITMUSEDGE_IP>",
        "NATS_PORT": "4222",
        "NATS_USER": "<access_token_username>",
        "NATS_PASSWORD": "<access_token_from_litmusedge>",

        "INFLUX_HOST": "<LITMUSEDGE_IP>",
        1. "INFLUX_PORT": "8086",
        "INFLUX_DB_NAME": "tsdata",
        "INFLUX_USERNAME": "<datahub_username>",
        "INFLUX_PASSWORD": "<datahub_password>"
      }
    }
  }
}

头部配置指南：

  • EDGE_URL: Litmus Edge 基础 URL（包括 https://）
  • EDGE_API_CLIENT_ID / EDGE_API_CLIENT_SECRET: 来自 Litmus Edge 的 OAuth2 凭证
  • NATS_SOURCE: Litmus Edge IP（无 http/https）
  • NATS_USER / NATS_PASSWORD: 来自 系统 → 访问控制 → 令牌 的访问令牌凭证
  • INFLUX_HOST: Litmus Edge IP（无 http/https）
  • INFLUX_USERNAME / INFLUX_PASSWORD: DataHub 用户凭证

更多信息请参阅 Cursor 文档。

可用工具

类别功能名称描述
DeviceHubget_litmusedge_driver_list列出支持的 Litmus Edge 驱动程序（例如，ModbusTCP、OPCUA、BACnet）。
get_devicehub_devices列出所有已配置的 DeviceHub 设备及其连接设置和状态。
create_devicehub_device创建具有指定驱动程序和默认配置的新设备。
get_devicehub_device_tags获取特定设备的所有标签（数据点/寄存器）。
get_current_value_of_devicehub_tag读取特定设备标签的当前实时值。
设备标识get_litmusedge_friendly_name获取分配给 Litmus Edge 设备的人类可读名称。
set_litmusedge_friendly_name更新 Litmus Edge 设备的友好名称。
LEM 集成get_cloud_activation_status检查云注册和 Litmus Edge Manager (LEM) 连接状态。
Docker 管理get_all_containers_on_litmusedge列出 Litmus Edge 市场上的所有 Docker 容器。
run_docker_container_on_litmusedge在 Litmus Edge 市场上部署并运行新的 Docker 容器。
NATS 主题 *get_current_value_from_topic订阅 NATS 主题并返回下一个发布的消息。
get_multiple_values_from_topic收集 NATS 主题的多个连续值以进行趋势分析。
InfluxDB **get_historical_data_from_influxdb根据测量值和时间范围查询 InfluxDB 中的历史时间序列数据。
数字孪生list_digital_twin_models列出所有数字孪生模型及其 ID、名称、描述和版本。
list_digital_twin_instances列出所有数字孪生实例或按模型 ID 过滤。
create_digital_twin_instance从现有模型创建新的数字孪生实例。
list_static_attributes列出模型或实例的静态属性（固定键值对）。
list_dynamic_attributes列出模型或实例的动态属性（实时数据点）。
list_transformations列出为数字孪生模型配置的数据转换规则。
get_digital_twin_hierarchy获取数字孪生模型的层次结构配置。
save_digital_twin_hierarchy将新的层次结构配置保存到数字孪生模型中。

配置注意事项

* NATS 主题工具需求： 要使用 get_current_value_from_topic 和 get_multiple_values_from_topic，您必须在 Litmus Edge 上配置访问控制：

  1. 导航至：Litmus Edge → 系统 → 访问控制 → 令牌
  2. 创建或配置一个具有适当权限的访问令牌
  3. 在您的 MCP 客户端配置头部提供该令牌

** InfluxDB 工具需求： 要使用 get_historical_data_from_influxdb，您必须允许 InfluxDB 端口访问：

  1. 导航至：Litmus Edge → 系统 → 网络 → 防火墙
  2. 添加防火墙规则以允许 TCP 端口 8086
  3. 确保 InfluxDB 可以从 MCP 服务器主机访问

使用

服务器发送事件 (SSE)

此服务器支持 MCP SSE 传输，用于实时通信。

  • 客户端端点: http://<server-ip>:8000/sse
  • 默认绑定: 0.0.0.0:8000/sse
  • 通信：
    • 服务器 → 客户端：通过 SSE 流式传输
    • 客户端 → 服务器：HTTP POST

Litmus 中央

通过 Litmus 中央 下载或试用 Litmus Edge。

集成

Cursor IDE

添加到 ~/.cursor/mcp.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "litmus-mcp-server": {
      "url": "http://<MCP_SERVER_IP>:8000/sse",
      "headers": {
        "EDGE_URL": "https://<LITMUSEDGE_IP>",
        "EDGE_API_CLIENT_ID": "<oauth2_client_id>",
        "EDGE_API_CLIENT_SECRET": "<oauth2_client_secret>",
        "NATS_SOURCE": "<LITMUSEDGE_IP>",
        "NATS_PORT": "4222",
        "NATS_USER": "<access_token_username>",
        "NATS_PASSWORD": "<access_token_from_litmusedge>",
        "INFLUX_HOST": "<LITMUSEDGE_IP>",
        "INFLUX_PORT": "8086",
        "INFLUX_DB_NAME": "tsdata",
        "INFLUX_USERNAME": "<datahub_username>",
        "INFLUX_PASSWORD": "<datahub_password>"
      }
    }
  }
}

Cursor 文档

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "litmus-mcp-server": {
      "url": "http://<MCP_SERVER_IP>:8000/sse",
      "headers": {
        "EDGE_URL": "https://<LITMUSEDGE_IP>",
        "EDGE_API_CLIENT_ID": "<oauth2_client_id>",
        "EDGE_API_CLIENT_SECRET": "<oauth2_client_secret>",
        "NATS_SOURCE": "<LITMUSEDGE_IP>",
        "NATS_PORT": "4222",
        "NATS_USER": "<access_token_username>",
        "NATS_PASSWORD": "<access_token_from_litmusedge>",
        "INFLUX_HOST": "<LITMUSEDGE_IP>",
        "INFLUX_PORT": "8086",
        "INFLUX_DB_NAME": "tsdata",
        "INFLUX_USERNAME": "<datahub_username>",
        "INFLUX_PASSWORD": "<datahub_password>"
      }
    }
  }
}

Anthropic 文档

VS Code / GitHub Copilot

手动配置

在 VS Code 中： 打开用户设置 (JSON) → 添加：

{
  "mcpServers": {
    "litmus-mcp-server": {
      "url": "http://<MCP_SERVER_IP>:8000/sse",
      "headers": {
        "EDGE_URL": "https://<LITMUSEDGE_IP>",
        "EDGE_API_CLIENT_ID": "<oauth2_client_id>",
        "EDGE_API_CLIENT_SECRET": "<oauth2_client_secret>",
        "NATS_SOURCE": "<LITMUSEDGE_IP>",
        "NATS_PORT": "4222",
        "NATS_USER": "<access_token_username>",
        "NATS_PASSWORD": "<access_token_from_litmusedge>",
        "INFLUX_HOST": "<LITMUSEDGE_IP>",
        "INFLUX_PORT": "8086",
        "INFLUX_DB_NAME": "tsdata",
        "INFLUX_USERNAME": "<datahub_username>",
        "INFLUX_PASSWORD": "<datahub_password>"
      }
    }
  }
}

或者使用项目中的 .vscode/mcp.json。

VS Code MCP 文档

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "litmus-mcp-server": {
      "url": "http://<MCP_SERVER_IP>:8000/sse",
      "headers": {
        "EDGE_URL": "https://<LITMUSEDGE_IP>",
        "EDGE_API_CLIENT_ID": "<oauth2_client_id>",
        "EDGE_API_CLIENT_SECRET": "<oauth2_client_secret>",
        "NATS_SOURCE": "<LITMUSEDGE_IP>",
        "NATS_PORT": "4222",
        "NATS_USER": "<access_token_username>",
        "NATS_PASSWORD": "<access_token_from_litmusedge>",
        "INFLUX_HOST": "<LITMUSEDGE_IP>",
        "INFLUX_PORT": "8086",
        "INFLUX_DB_NAME": "tsdata",
        1. "INFLUX_USERNAME": "<datahub_username>",
        "INFLUX_PASSWORD": "<datahub_password>"
      }
    }
  }
}

Windsurf MCP 文档

MCP 服务器注册表

<a href="https://glama.ai/mcp/servers/@litmusautomation/litmus-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@litmusautomation/litmus-mcp-server/badge" alt="Litmus MCP 服务器" /> </a>

© 2025 Litmus Automation, Inc. 保留所有权利。