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。