supOS MCP 服务器

supOS MCP 服务器

基于 MCP 协议的 supOS 开放 API 服务,支持主题树查询、实时数据等功能。

快速入门

系统要求

  • 安装 Node.js

配置客户端

  1. 使用支持 MCP 协议的客户端(如 Claude for Desktop)。
  2. 修改配置文件 claude_desktop_config.json
    {
      "mcpServers": {
        "supos": {
          "command": "npx",
          "args": ["-y", "mcp-server-supos"],
          "env": {
            "SUPOS_API_KEY": "<API_KEY>",
            "SUPOS_API_URL": "<API_URL>",
            "SUPOS_MQTT_URL": "<MQTT_URL>"
          }
        }
      }
    }
    
  3. 重启客户端。

本地运行服务

  1. 全局安装:npm install mcp-server-supos -g
  2. 修改配置为本地路径,例如:
    {
      "mcpServers": {
        "supos": {
          "command": "node",
          "args": ["<安装路径>/index.js"]
        }
      }
    }
    
  3. 或者克隆源码并构建:
    git clone https://github.com/FREEZONEX/mcp-server-supos.git
    npm ci && npm run build
    
  4. 修改配置为目标路径并重启。

自动安装

使用 Smithery 工具:

npx -y @smithery/cli install @FREEZONEX/mcp-server-supos --client claude