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 参数动态覆盖默认配置。

🤝 贡献

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