AAS管理协议服务器

aas-mcp是一个模型上下文协议(MCP)服务器,为AI助手提供通过Eclipse BaSyx REST API与资产管理壳(AAS)交互的工具,适用于工业自动化、数字孪生管理和基于AAS的工作流程。

  • by SmartFactory-KL
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 SmartFactory-KL/aas-mcp

使用说明

aas-mcp 是一个 模型上下文协议(MCP) 为AI助手提供交互工具的服务器 资产管理外壳(AAS) 通过 日蚀BaSyx REST API。

此MCP服务器使AI助手能够对AAS外壳、子模型和子模型元素执行完整的CRUD操作,使其成为工业自动化、数字孪生管理和基于AAS的工作流的理想选择。

特性

  • 🤖 MCP服务器 使用25多种工具进行全面的AAS管理
  • 🔧 完整的CRUD操作 关于外壳、子模型和子模型元素
  • ⚙️ 健康监测 AAS环境状态工具
  • 🔁 无缝集成 随着 日蚀BaSyx 环境REST API
  • 📡 AI就绪 为智能自动化工作流程设计的工具

🚀 安装

pip install aas-mcp

需要:Python 3.10+

🚀 用法

运行MCP服务器

# Start the MCP server
aas-mcp

可用工具

MCP服务器为AAS管理提供了25多种工具:

壳牌管理

  • get_shells -检索所有AAS外壳
  • get_shell -按ID获取特定的Shell
  • create_shell -创建新Shell
  • update_shell -更新现有Shell
  • delete_shell -删除外壳

子模型管理

  • get_submodels -检索所有子模型
  • get_submodel -按ID获取特定的子模型
  • create_submodel -创建新的子模型
  • update_submodel -更新现有子模型
  • delete_submodel -删除子模型
  • get_submodel_value -获取子模型原始值
  • update_submodel_value -更新子模型值
  • get_submodel_metadata -获取子模型元数据

子模型元素管理

  • get_submodel_elements -从子模型中获取所有元素
  • get_submodel_element -按路径获取特定元素
  • create_submodel_element -创建新元素
  • update_submodel_element -更新现有元素
  • delete_submodel_element -删除元素
  • get_submodel_element_value -获取元素原始值
  • update_submodel_element_value -更新元素值

参考资料管理

  • get_submodel_refs -从Shell获取子模型引用
  • create_submodel_ref -创建子模型引用
  • delete_submodel_ref -删除子模型引用

健康与监测

  • get_health_status -检查AAS环境健康状况
  • is_healthy -布尔健康检查

🔧 配置

MCP客户端配置

将此服务器与MCP客户端一起使用,如 克劳德桌面,将其添加到客户端的配置中:

{
  "mcpServers": {
    "aas-mcp": {
      "command": "aas-mcp",
      "env": {
        "SHELLSMITH_BASYX_ENV_HOST": "http://localhost:8081"
      }
    }
  }
}

ℹ️ 更改值 SHELLSMITH_BASYX_ENV_HOST 匹配您的BaSyx环境主机URL

配置格式与LM Studio等其他MCP客户端类似。

BaSyx环境配置

MCP服务器连接到Eclipse BaSyx环境。默认主机为:

http://localhost:8081

您可以通过多种方式覆盖它:

  • 设置环境变量:

    export SHELLSMITH_BASYX_ENV_HOST=https://your-host:1234
    
  • 创建一个 .env 工作目录中的文件,其中包含:

    SHELLSMITH_BASYX_ENV_HOST=https://your-host:1234
    

每个工具还接受 host 参数动态覆盖默认配置。

🤝 贡献

我们欢迎捐款!请参阅我们关于设置、测试和编码标准的贡献指南。