FREEZONEX MCP Server Supos

🚀 supOS MCP 服务器

本 MCP 服务器基于 Model Context Protocol (MCP) 协议的 typescript-sdk 开发，支持任何符合 MCP 协议的客户端使用。它提供了一系列 supOS 的开放 API，可用于查询主题树结构、获取主题详情等，为开发者提供了便捷的操作方式。

✨ 主要特性

• 基于 MCP 协议的 typescript-sdk 开发，兼容性强，支持任意符合 MCP 协议的客户端。
• 提供丰富的 supOS 开放 API，满足多样化的业务需求。

📦 安装指南

系统要求

• Node.js

安装客户端

目前支持 MCP 协议的客户端有多种，例如桌面端应用 Claude for Desktop 或者一些 IDE 插件（如 VSCode 的 Cline 插件）。想了解已支持的客户端，请访问 Model Context Protocol Client。

这里以 Claude for Desktop 为例：

• 下载 Claude for Desktop。
• 为 Claude for Desktop 配置 MCP 服务器。

配置步骤

1. 基于 typescript-sdk 的安装方式

npm install typescript-sdk

2. 运行示例代码

const { supOS } = require('typescirpt-sdk');
const client = new supOS.MCPClient({
  key: 'your_api_key',
  secret: 'your_api_secret'
});
await client.connect();
console.log('连接成功');

💻 使用示例

基础用法

创建 MCP 客户端实例

const { MCPClient } = require('typescript-sdk');
const client = new MCPClient({
  key: 'your_api_key',
  secret: 'your_api_secret'
});

连接到 MCP 服务器

await client.connect();
console.log('已连接到 MCP 服务器');

调用 API 方法

• 获取主题树结构

const tree = await client.getmodeltopicTree();
console.log(tree);

• 获取某个主题的详细信息

const detail = await client.getmodeltopicDetail('your_topic_path');
console.log(detail);

📚 详细文档

支持的 API

工具

1. get-model-topic-tree
   • 功能：查询主题树结构菜单数据
   • 输入：
     • key (字符串)：子节点的模糊搜索关键字
     • showRec (布尔值)：显示记录的数量
     • type (字符串)：搜索类型，1--文本搜索，2--标签搜索
   • 返回：主题树结构菜单数据
2. get-model-topic-detail
   • 功能：获取某个主题的详细信息
   • 输入：
     • topic (字符串)：对应模型的主题路径
   • 返回：某个主题的详细信息
3. get-topic-realtime-data
   • 功能：获取某个主题的实时数据
   • 输入：
     • topic (字符串)：对应模型的主题路径
   • 返回：某个主题的实时数据
4. get-all-topic-realtime-data
   • 功能：获取所有主题的实时数据并进行分析
   • 返回：所有主题的实时数据

结语

以上就是使用该服务的全部教程，配置成功后可以在以下面板中看到对应的服务和工具等：

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