返回 MCP 目录
public公开dns本地运行

mcp-server-supos

基于MCP协议的supOS服务器,提供数据查询和实时监控功能

article

README

🚀 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

配置步骤

  1. 克隆仓库:

    git clone https://github.com/FREEZONEX/mcp-server-supos.git
    
  2. 安装依赖项:

    npm ci
    
  3. 构建项目:

    npm run build
    
  4. 配置 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"
          }
        }
      }
    }
    

注意事项

⚠️ 重要提示

请确保所有环境变量值已正确配置,在生产环境中,建议使用 HTTPS 协议。

📚 详细文档

支持的 API

工具

  1. get-model-topic-structure
    获取模型主题结构。

  2. get-model-details
    获取模型详细信息。

  3. generate-content
    根据给定的主题生成内容。

  4. query-knowledge-base
    查询知识库。

  5. save-to-database
    将数据保存到数据库。

  6. publish-output
    发布输出结果。

📄 许可证

此项目在 Apache License 2.0 下许可 - 请查看 LICENSE 文件以获取详细信息。

🔚 总结

完成以上配置后,您可以在以下面板中看到对应的服务和工具: alt text alt text alt text

最终说明

supOS 社区版已集成由 CopilotKit 作者开源的 open-mcp-client,并内置了 mcp-server-supos 服务,支持 ts 版本 agent。源代码可访问 supOS-CE-McpClient

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端