[{"_1":2,"_332":-5,"_333":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_24":25,"_246":247},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","J23Z5bYdXv","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":-5,"_27":28,"_29":30,"_166":167},"githubUser","maintainer",false,"mcpServer",{"_31":32,"_33":34,"_13":49,"_58":59,"_60":59,"_61":62,"_67":68,"_91":-5,"_92":93,"_94":95,"_96":97,"_77":108,"_109":82,"_110":111,"_114":-5,"_115":116,"_117":118,"_125":-5,"_126":127,"_132":-5,"_104":78,"_133":134,"_137":138,"_17":163,"_164":165},"addedAt",["D",1741480443652],"argumentsJsonSchema",{"_35":36,"_46":47,"_41":48},"properties",{"_37":38,"_43":44},"SUPOS_API_KEY",{"_39":40,"_41":42},"description","API key for supOS obtained from DataModeling -> topic details -> Data Operation -> Fetch","type","string","SUPOS_API_URL",{"_39":45,"_41":42},"The URL of the accessible supOS community version (e.g., https://supos-demo.supos.app/)","required",[37,43],"object",[50,51,52,53,54,55,56,57],"category:databases","category:cloud-platforms","category:developer-tools","hosting:hybrid","language:javascript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","An MCP protocol server that provides access to supOS open APIs, allowing MCP-compatible clients to query topic tree structures and details.","descriptionPlainText","githubProject",{"_63":64,"_65":66},"readme","# supOS MCP Server\n\n本MCP服务器是基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) 协议提供的 `typescript-sdk` 进行开发，可以让任何支持MCP协议的客户端使用它。 \n\n它提供了一系列supOS的open-api，例如：查询topic树结构，topic详情等。\n\n\n $\"supOS$ \n \n\n## 支持的API\n\n### Tools\n1. `get-model-topic-tree`\n - 查询topic 树结构菜单数据\n - 输入:\n - `key` (string): Fuzzy search keyword for child nodes\n - `showRec` (boolean): Number of records to display\n - `type` (string): Search type: 1--Text search, 2--Tag search\n - 返回: topic 树结构菜单数据\n\n2. `get-model-topic-detail`\n - 获取某个topic详情\n - 输入:\n - `topic` (string): The topic path corresponding to the model\n - 返回: 某个topic详情\n3. `get-topic-realtime-data`\n - 获取某个topic的实时数据\n - 输入:\n - `topic` (string): The topic path corresponding to the model\n - 返回: 某个topic实时数据\n4. `get-all-topic-realtime-data`\n - 获取所有topic的实时数据并分析\n - 返回: 所有topic实时数据\n\n***接下来跟随文档一起使用吧***\n\n## 开始使用\n\n### 系统要求\n- Node.js\n\n### 安装客户端\n目前支持MCP协议的客户端已有很多，比如桌面端应用 `Claude for Desktop`，或者IDE的一些插件等（`VSCode` 的 `Cline` 插件），想了解已支持的客户端可访问 [Model Context Protocol Client](https://modelcontextprotocol.io/clients)。\n\n这里以 `Claude for Desktop` 为例。\n- 下载 [Claude for Desktop](https://claude.ai/download)。\n- 为 `Claude for Desktop` 配置所需的MCP 服务器。\n\n- - 在文本编辑器中打开您的 `Claude for Desktop` 配置：`~/Library/Application Support/Claude/claude_desktop_config.json`。\n- - 也可以通过 `File -> Setting -> Developer` 点击 `Edit Config` 找到该配置文件位置：\n![alt text](./public/image.png)\n![alt text](./public/image-1.png)\n![alt text](./public/image-6.png)\n- - 打开配置文件后，添加以下内容到 `claude_desktop_config.json`中，并重启应用: \n*注意：每次修改该配置文件后都需要重启应用才会生效。*\n\n ```json\n {\n \"mcpServers\": {\n \"supos\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-server-supos\"\n ],\n \"env\": {\n \"SUPOS_API_KEY\": \"\",\n \"SUPOS_API_URL\": \"\",\n \"SUPOS_MQTT_URL\": \"\"\n }\n }\n }\n }\n ```\n- - 其中 `API_URL` 是可访问的[supOS社区版](https://supos-demo.supos.app/)地址。`API_KEY` 可通过登录社区版后，进入 `DataModeling -> 查看某个具体的topic详情 -> Data Operation -> Fetch`，找到对应的ApiKey复制即可，`MQTT_URL`可通过访问 `UNS -> MqttBroker -> Listeners` 查看可订阅的地址。\n\n**注意：以上配置MCP服务器是借助 `npx` 拉取 `mcp-server-supos` npm包并在本地运行的方式给客户端提供服务。但 `npx` 在 `Windows` 系统下读取环境变量 `env` 配置时可能会出错，因此可以采用下面方式解决：**\n\n### 本地运行服务\n以下两种方式选择一种即可：\n\n- 本地安装 `mcp-server-supos`，并通过node运行\n\n1. Install\n```bash\nnpm install mcp-server-supos -g\n```\n\n2. 找到安装的包路径，例如： `\"C://Users////AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js\"`\n\n3. 修改 `claude_desktop_config.json` 的配置，并重启应用\n```json\n{\n \"mcpServers\": {\n \"supos\": {\n \"command\": \"node\",\n \"args\": [\n \"C://Users////AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js\"\n ],\n \"env\": {\n \"SUPOS_API_KEY\": \"\",\n \"SUPOS_API_URL\": \"\",\n \"SUPOS_MQTT_URL\": \"\"\n }\n }\n }\n}\n```\n\n- 下载本仓库源码本地编译执行\n\n1. 复制仓库:\n```bash\ngit clone https://github.com/FREEZONEX/mcp-server-supos.git\n```\n2. 安装依赖\n```bash\nnpm ci\n```\n3. 编译\n```bash\nnpm run build\n```\n4. 修改 `claude_desktop_config.json` 的配置，并重启应用\n```json\n{\n \"mcpServers\": {\n \"supos\": {\n \"command\": \"node\",\n \"args\": [\n \"<本地项目地址>//dist//index.js\"\n ],\n \"env\": {\n \"SUPOS_API_KEY\": \"\",\n \"SUPOS_API_URL\": \"\",\n \"SUPOS_MQTT_URL\": \"\"\n }\n }\n }\n}\n```\n\n### 结语\n以上就是使用该服务的全部教程，配置成功后可在以下面板中看到对应的服务和工具等：\n![alt text](./public/image-2.png)\n![alt text](./public/image-3.png)\n![alt text](./public/image-4.png)\n\n### 最后的最后\n[supOS社区版](https://supos-demo.supos.app/) 已集成 `CopilotKit` 作者开源的 [open-mcp-client](https://github.com/CopilotKit/open-mcp-client)，并内置了 `mcp-server-supos` 服务，且支持ts版本的 `agent`，源码可访问 [supOS-CE-McpClient](https://github.com/FREEZONEX/supOS-CE-McpClient)。","url","https://github.com/FREEZONEX/mcp-server-supos","githubRepository",{"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":80,"_84":85,"_86":87,"_89":90},"defaultBranch","main","fullName","FREEZONEX/mcp-server-supos","githubTreeId",104719,"language","JavaScript","name","mcp-server-supos","owner",{"_81":82,"_17":83},"login","FREEZONEX","Yr5r7ecVNJ","recentStargazers",1,"spdxLicense",{"_77":88},"Apache 2.0","stargazers",2,"glamaJson","id",1574,"inspectable",true,"integrations",[98],{"_99":100,"_39":106,"_17":107},"brand",{"_101":102,"_77":103,"_104":105},"logoSvgPath","M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","slug","node-dot-js","Provides tools to interact with supOS's API, enabling users to query topic tree structures and retrieve topic details from supOS models.","hmec5b2cmz","supOS MCP Server","namespace","npmPackage",{"_77":78,"_112":113},"weeklyDownloads",987,"prompts","redditPostForeignId","1j6w2k4","relatedMcpServerIds",[119,120,121,122,123,124],820,652,1240,548,624,180,"resources","scores",{"_128":129,"_130":129,"_131":129},"license",100,"quality","security","simpleIcon","supportedPlatforms",[135,136],"WINDOWS","MACOS","tools",[139,156],{"_77":140,"_141":142},"get-model-topic-tree","inputSchema",{"_41":48,"_143":144,"_35":145,"_155":28},"$schema","http://json-schema.org/draft-07/schema#",{"_146":147,"_41":149,"_151":152},"key",{"_41":42,"_39":148},"Fuzzy search keyword for child nodes",{"_41":42,"_39":150},"Search type: 1--Text search, 2--Tag search","showRec",{"_41":153,"_39":154},"boolean","Is show recommend topic","additionalProperties",{"_77":157,"_141":158},"get-model-topic-detail",{"_41":48,"_143":144,"_46":159,"_35":161,"_155":28},[160],"topic",{"_160":162},{"_41":42},"7ayh12mg77","updatedAt",["D",1743487357900],"meta",[168,171,173,180,183,185,188,191,194,197,200,202,205,208,210,212,214,216,218],{"_169":170},"title","supOS MCP Server | Glama",{"_172":59,"_77":39},"content",{"_174":175,"_176":177,"_178":179},"href","https://glama.ai/mcp/servers/@FREEZONEX/mcp-server-supos","rel","canonical","tagName","link",{"_172":108,"_181":182},"property","og:title",{"_172":59,"_181":184},"og:description",{"_172":186,"_181":187},"https://glama.ai/logo.png","og:logo",{"_172":189,"_181":190},"https://glama.ai/mcp/servers/@FREEZONEX/mcp-server-supos/og-image","og:image",{"_172":192,"_181":193},"630","og:image:height",{"_172":195,"_181":196},"1200","og:image:width",{"_172":198,"_181":199},"website","og:type",{"_172":175,"_181":201},"og:url",{"_172":203,"_181":204},"ChatGPT alternative for power users","og:site_name",{"_172":206,"_77":207},"summary_large_image","twitter:card",{"_172":203,"_77":209},"twitter:title",{"_172":59,"_77":211},"twitter:description",{"_172":189,"_77":213},"twitter:image",{"_172":192,"_77":215},"twitter:image:height",{"_172":195,"_77":217},"twitter:image:width",{"_219":220},"script:ld+json",{"_221":222,"_223":224},"@context","http://schema.org","@graph",[225],{"_221":226,"_227":228,"_229":230},"https://schema.org","@type","BreadcrumbList","itemListElement",[231,237,240,244],{"_227":232,"_233":234,"_77":235,"_236":85},"ListItem","item","https://glama.ai/","Glama","position",{"_227":232,"_233":238,"_77":239,"_236":90},"https://glama.ai/mcp","MCP",{"_227":232,"_233":241,"_77":242,"_236":243},"https://glama.ai/mcp/servers","Servers",3,{"_227":232,"_233":175,"_77":108,"_236":245},4,"routes/_public/mcp/servers/~namespace/~slug/_pages/tools/~toolName/_route",{"_29":248,"_280":-5,"_281":282,"_166":288,"_325":326,"_11":331},{"_31":249,"_33":250,"_13":255,"_58":59,"_60":59,"_61":256,"_67":257,"_91":-5,"_92":93,"_94":95,"_96":260,"_77":108,"_109":82,"_110":263,"_114":-5,"_115":116,"_117":264,"_125":-5,"_126":265,"_132":-5,"_104":78,"_133":266,"_137":267,"_17":163,"_164":279},["D",1741480443652],{"_35":251,"_46":254,"_41":48},{"_37":252,"_43":253},{"_39":40,"_41":42},{"_39":45,"_41":42},[37,43],[50,51,52,53,54,55,56,57],{"_63":64,"_65":66},{"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":258,"_84":85,"_86":259,"_89":90},{"_81":82,"_17":83},{"_77":88},[261],{"_99":262,"_39":106,"_17":107},{"_101":102,"_77":103,"_104":105},{"_77":78,"_112":113},[119,120,121,122,123,124],{"_128":129,"_130":129,"_131":129},[135,136],[268,274],{"_77":140,"_141":269},{"_41":48,"_143":144,"_35":270,"_155":28},{"_146":271,"_41":272,"_151":273},{"_41":42,"_39":148},{"_41":42,"_39":150},{"_41":153,"_39":154},{"_77":157,"_141":275},{"_41":48,"_143":144,"_46":276,"_35":277,"_155":28},[160],{"_160":278},{"_41":42},["D",1743487357900],"mcpServerInstance","mcpServerTool",{"_39":-5,"_92":283,"_141":284,"_77":157},12572,{"_143":144,"_155":28,"_35":285,"_46":287,"_41":48},{"_160":286},{"_41":42},[160],[289,291,292,293,295,296,297,298,299,300,301,302,303,304,305,306,307,308,309],{"_169":290},"get-model-topic-detail - supOS MCP Server | Glama",{"_172":59,"_77":39},{"_174":175,"_176":177,"_178":179},{"_172":294,"_181":182},"get-model-topic-detail - supOS MCP Server",{"_172":59,"_181":184},{"_172":186,"_181":187},{"_172":189,"_181":190},{"_172":192,"_181":193},{"_172":195,"_181":196},{"_172":198,"_181":199},{"_172":175,"_181":201},{"_172":203,"_181":204},{"_172":206,"_77":207},{"_172":203,"_77":209},{"_172":59,"_77":211},{"_172":189,"_77":213},{"_172":192,"_77":215},{"_172":195,"_77":217},{"_219":310},{"_221":222,"_223":311},[312],{"_221":226,"_227":228,"_229":313},[314,315,316,317,318,322],{"_227":232,"_233":234,"_77":235,"_236":85},{"_227":232,"_233":238,"_77":239,"_236":90},{"_227":232,"_233":241,"_77":242,"_236":243},{"_227":232,"_233":175,"_77":108,"_236":245},{"_227":232,"_233":319,"_77":320,"_236":321},"https://glama.ai/mcp/servers/@FREEZONEX/mcp-server-supos/tools","Tools",5,{"_227":232,"_233":323,"_77":157,"_236":324},"https://glama.ai/mcp/servers/@FREEZONEX/mcp-server-supos/tools/get-model-topic-detail",6,"otherTools",[327,329],{"_29":328,"_77":140},{"_109":82,"_104":78,"_17":163},{"_29":330,"_77":157},{"_109":82,"_104":78,"_17":163},{"_19":-5},"actionData","errors"]

get-model-topic-detail

Input Schema

Input Schema (JSON Schema)

Other Tools