Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client