README
🚀 supOS MCP 服务器
supOS MCP 服务器基于 模型上下文协议 (MCP) 协议提供的 typescript-sdk 开发,可供任何支持 MCP 协议的客户端使用。它提供了一系列 supOS 开放 API,能实现查询主题树结构、主题详细信息等功能。
🚀 快速开始
supOS MCP 服务器基于 MCP 协议的 typescript-sdk 开发,支持 MCP 协议的客户端均可使用。它提供了丰富的 supOS 开放 API,满足多种业务需求。
✨ 主要特性
- 基于 MCP 协议的
typescript-sdk开发,兼容性强。 - 提供一系列 supOS 开放 API,如查询主题树结构、主题详细信息等。
📦 安装指南
系统要求
- Node.js (推荐使用版本 14 或更高)
- npm (推荐使用版本 6 或更高)
客户端安装
npm install mcp-client-supos
配置步骤
-
克隆仓库:
git clone https://github.com/FREEZONEX/mcp-server-supos.git -
安装依赖项:
npm ci -
构建项目:
npm run build -
配置
claude-desk-config.json文件,添加以下内容:{ "mcpServers": { "supos": { "command": "node", "args": ["dist/index.js"], "env": { "SUPOS_API_KEY": "your_api_key", "SUPOS_API_URL": "https://api.supos-demo.app", "SUPOS_MQTT_URL": "ws://supos-mqtt-broker:1883" } } } }
注意事项
⚠️ 重要提示
请确保所有环境变量值已正确配置,在生产环境中,建议使用 HTTPS 协议。
📚 详细文档
支持的 API
工具
-
get-model-topic-structure
获取模型主题结构。 -
get-model-details
获取模型详细信息。 -
generate-content
根据给定的主题生成内容。 -
query-knowledge-base
查询知识库。 -
save-to-database
将数据保存到数据库。 -
publish-output
发布输出结果。
📄 许可证
此项目在 Apache License 2.0 下许可 - 请查看 LICENSE 文件以获取详细信息。
🔚 总结
完成以上配置后,您可以在以下面板中看到对应的服务和工具:

最终说明
supOS 社区版已集成由 CopilotKit 作者开源的 open-mcp-client,并内置了 mcp-server-supos 服务,支持 ts 版本 agent。源代码可访问 supOS-CE-McpClient。
Scan to join WeChat group