什么是supOS MCP服务器？

supOS MCP服务器是一个基于MCP协议构建的服务端，允许任何支持MCP协议的客户端调用其开放API。它提供了查询主题树结构、获取具体主题详情以及实时数据等功能。

如何使用supOS MCP服务器？

通过配置客户端（如Claude for Desktop）连接到本地运行的服务，即可轻松使用。支持多种API接口，涵盖模型管理、数据操作等领域。

适用场景

适用于工业物联网、智能制造等领域，可用于快速构建基于MCP协议的数据驱动应用。

主要功能

获取主题树结构通过关键词模糊搜索或标签筛选，快速获取主题树形菜单数据。

获取具体主题详情输入特定主题路径，查询该主题的详细信息。

获取实时数据支持单个主题或全部主题的实时数据查询及分析。

优势与局限性

优势

支持MCP协议，兼容性强。

提供丰富的开放API，满足多场景需求。

易于部署和扩展，降低开发成本。

局限性

对环境有一定依赖性，需安装Node.js。

部分高级功能可能需要特定权限配置。

如何使用

下载并安装客户端

下载支持MCP协议的客户端工具（如Claude for Desktop），并完成初始设置。

配置MCP服务器

编辑客户端配置文件（如claude_desktop_config.json），添加服务器地址及相关参数。

启动服务

确保本地服务已正常启动，并验证客户端连接状态。

使用案例

案例1：查询主题树结构输入关键词'生产计划'，获取与生产计划相关的主题树结构。

案例2：获取实时数据查询主题'设备状态'的最新实时数据。

常见问题

如何安装MCP服务器？

为什么无法连接到MCP服务器？

如何查看API密钥？

🚀 supOS MCP 服务器

supOS MCP 服务器基于模型上下文协议 (MCP) 协议提供的 typescript-sdk 开发，可供任何支持 MCP 协议的客户端使用。它提供了一系列 supOS 开放 API，能实现查询主题树结构、主题详细信息等功能。

🚀 快速开始

supOS MCP 服务器基于 MCP 协议的 typescript-sdk 开发，支持 MCP 协议的客户端均可使用。它提供了丰富的 supOS 开放 API，满足多种业务需求。

✨ 主要特性

基于 MCP 协议的 typescript-sdk 开发，兼容性强。
提供一系列 supOS 开放 API，如查询主题树结构、主题详细信息等。

📦 安装指南

系统要求

Node.js (推荐使用版本 14 或更高)
npm (推荐使用版本 6 或更高)

客户端安装

npm install mcp-client-supos

配置步骤

克隆仓库:

git clone https://github.com/FREEZONEX/mcp-server-supos.git

安装依赖项:
```
npm ci
```
构建项目:
```
npm run build
```

配置 claude-desk-config.json 文件，添加以下内容：

{
  "mcpServers": {
    "supos": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "SUPOS_API_KEY": "your_api_key",
        "SUPOS_API_URL": "https://api.supos-demo.app",
        "SUPOS_MQTT_URL": "ws://supos-mqtt-broker:1883"
      }
    }
  }
}