麦克服支持服务器

Name: 麦克服支持服务器
Author: FREEZONEX

作者：FREEZONEX8 星标更新：2025-06-13

安装使用来源：spider==github.com

项目介绍

English | 中文

supOS MCP Server

此MCP服务器基于由模型上下文协议（MCP）提供的typescript-sdk开发，允许任何支持MCP协议的客户端使用它。

它提供了一系列supOS开放API，例如查询主题树结构、主题详情等。

支持的API

工具

get-topic-tree
- 查询主题树结构菜单数据
- 输入参数：
  - key (字符串)：子节点的模糊搜索关键词
  - showRec (布尔值)：显示记录数
  - type (字符串)：搜索类型：1--文本搜索，2--标签搜索
- 返回值：主题树结构菜单数据
get-topic-detail
- 获取特定主题的详细信息
- 输入参数：
  - topic (字符串)：与模型对应的主题路径
- 返回值：特定主题的详细信息
get-topic-realtime-data
- 获取特定主题的实时数据
- 输入参数：
  - topic (字符串)：与模型对应的主题路径
- 返回值：特定主题的实时数据
get-all-topic-realtime-data
- 获取并分析所有主题的实时数据
- 返回值：所有主题的实时数据
pg-query-sql
- 在pg数据库上执行SQL查询
- 输入参数：
  - sql (字符串)：要执行的SQL语句
  - params (数组)：SQL参数数组，可选
- 返回值：SQL查询结果
get-topic-history-data-by-pg
- 获取特定主题的历史数据
- 输入参数：
  - prompt (字符串)：用户输入的用于查询主题历史数据的提示信息
- 返回值：查询主题历史数据的逐步提示，便于逐步调用工具获取历史数据
get-topic-query-sql
- 获取查询特定主题的SQL语句
- 输入参数：
  - prompt (字符串)：用户输入的用于查询主题的SQL语句提示
- 返回值：查询主题的逐步提示，便于逐步调用工具生成SQL语句

让我们按照文档开始使用吧

开始使用

系统要求

Node.js

安装客户端

目前有许多支持MCP协议的客户端，如桌面应用Claude for Desktop或IDE插件（如VSCode的Cline插件）。有关支持的客户端，请访问模型上下文协议客户端。

这里我们将以Claude for Desktop为例。

下载Claude for Desktop。
配置Claude for Desktop所需的MCP服务器。
打开你的Claude for Desktop配置文件：~/Library/Application Support/Claude/claude_desktop_config.json。
也可以通过点击文件 -> 设置 -> 开发者中的编辑配置来找到配置文件的位置：

打开配置文件后，在claude_desktop_config.json中添加以下内容，并重启应用程序： 注意：每次修改此配置文件后都需要重启应用程序才能生效。

  ```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>",
          "SUPOS_PG_URL": "<PG_URL>"
        }
      }
    }
  }
  ```

其中API_URL是supOS社区版的可访问地址，可以从这里尝试入口点。API_KEY是访问开放API所需的关键字。MQTT_URL可以通过访问UNS -> MqttBroker -> Listeners查看可订阅地址。PG_URL是访问pg数据库所需的URL，格式：postgresql://user:password@host:port/db-name

注意：上述MCP服务器配置使用npx拉取mcp-server-suposnpm包并在本地运行以向客户端提供服务。然而，在Windows系统上，npx可能无法正确读取环境变量env配置，因此可以采用以下解决方案：

在本地运行服务

选择以下两种方法之一：

在本地安装mcp-server-supos并通过node运行

安装

npm install mcp-server-supos -g

查找已安装包的路径，例如："C://Users//<USER_NAME>//AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js"
修改claude_desktop_config.json中的配置并重启应用程序

{
  "mcpServers": {
    "supos": {
      "command": "node",
      "args": [
        "C://Users//<USER_NAME>//AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js"
      ],
      "env": {
        "SUPOS_API_KEY": "<API_KEY>",
        "SUPOS_API_URL": "<API_URL>",
        "SUPOS_MQTT_URL": "<MQTT_URL>",
        "SUPOS_PG_URL": "<PG_URL>"
      }
    }
  }
}

在本地下载并编译仓库源代码

克隆仓库：

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

安装依赖项

npm ci

构建

npm run build

修改claude_desktop_config.json中的配置并重启应用程序

{
  "mcpServers": {
    "supos": {
      "command": "node",
      "args": ["<local project path>//dist//index.js"],
      "env": {
        "SUPOS_API_KEY": "<API_KEY>",
        "SUPOS_API_URL": "<API_URL>",
        "SUPOS_MQTT_URL": "<MQTT_URL>",
        "SUPOS_PG_URL": "<PG_URL>"
      }
    }
  }
}

结论

以上就是使用该服务的完整教程。成功配置后，您可以在以下面板中看到相应的服务和工具： alt text

通过Smithery安装

要通过Smithery自动为Claude Desktop安装supOS MCP Server：

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

最终说明

supOS社区版集成了由CopilotKit作者开源的open-mcp-client，内置了mcp-server-supos服务，支持ts版本agent。

许可证

本项目根据Apache许可证2.0发布 - 详情见LICENSE文件。