什麼是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"
      }
    }
  }
}