FREEZONEX MCP Server Supos

🚀 supOS MCP Server

This MCP server is developed based on the typescript-sdk of the Model Context Protocol (MCP). It supports any client compliant with the MCP protocol. It offers a series of open APIs for supOS, such as querying the topic tree structure and topic details.

🚀 Quick Start

System Requirements

• Node.js

Install the Client

Currently, there are various clients that support the MCP protocol, such as the desktop application Claude for Desktop or some IDE plugins (e.g., the Cline plugin for VSCode). To learn about the supported clients, please visit Model Context Protocol Client.

Here is an example using Claude for Desktop:

• Download Claude for Desktop.
• Configure the MCP server for Claude for Desktop.

Configuration Steps

1. Installation based on typescript-sdk

   npm install typescript-sdk
   

2. Run the example code

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

Usage Instructions

1. Create an MCP client instance

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

2. Connect to the MCP server

   await client.connect();
   console.log('Connected to the MCP server');
   

3. Call API methods

   • Get the topic tree structure:

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

   • Get the detailed information of a topic:

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

✨ Features

Supported APIs

Tools

1. get-model-topic-tree

   • Query the menu data of the topic tree structure.
   • Input:
     • key (string): Fuzzy search keyword for child nodes.
     • showRec (boolean): Number of records to display.
     • type (string): Search type: 1 - text search, 2 - tag search.
   • Return: Menu data of the topic tree structure.

2. get-model-topic-detail

   • Get the detailed information of a specific topic.
   • Input:
     • topic (string): Topic path of the corresponding model.
   • Return: Detailed information of a specific topic.

3. get-topic-realtime-data

   • Get the real - time data of a specific topic.
   • Input:
     • topic (string): Topic path of the corresponding model.
   • Return: Real - time data of a specific topic.

4. get-all-topic-realtime-data

   • Get and analyze the real - time data of all topics.
   • Return: Real - time data of all topics.

📚 Conclusion

The above is the complete tutorial for using this service. After successful configuration, you can see the corresponding services and tools in the following panel:

The supOS Community Edition has integrated the open - mcp - client open - sourced by the author of CopilotKit, and has built - in the mcp - server - supos service, and supports the TypeScript version of the proxy. You can access the source code at [supOS - CE - McpClient](https://github.com/FREEZONEX/supOS - CE - McpClient).