ation: *Note: The application needs to be restarted after each modification of this configuration file for changes to take effect.* ```json { "mcpServers": { "supos": { "command": "npx", "args": [ "-y", "mcp-server-supos" ], "env": { "SUPOS_API_KEY": "", "SUPOS_API_URL": "", "SUPOS_MQTT_URL": "" } } } } ``` - - Where `API_URL` is the accessible address of [supOS Community Edition](https://supos-demo.supos.app/). `API_KEY` can be found by logging into the community edition, going to `DataModeling -> View specific topic details -> Data Operation -> Fetch`, and copying the corresponding ApiKey. `MQTT_URL` can be found by visiting `UNS -> MqttBroker -> Listeners` to view the subscribable address. **Note: The above configuration of the MCP server uses `npx` to pull the `mcp-server-supos` npm package and run it locally to provide services to clients. However, `npx` may have issues reading environment variable `env` configurations on `Windows` systems, so the following solutions can be adopted:** ### Running Service Locally Choose one of the following two methods: - Install `mcp-server-supos` locally and run it through node 1. Install ```bash npm install mcp-server-supos -g ``` 2. Find the installed package path, for example: `"C://Users////AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js"` 3. Modify the configuration in `claude_desktop_config.json` and restart the application ```json { "mcpServers": { "supos": { "command": "node", "args": [ "C://Users////AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js" ], "env": { "SUPOS_API_KEY": "", "SUPOS_API_URL": "", "SUPOS_MQTT_URL": "" } } } } ``` - Download and compile the repository source code locally 1. Clone the repository: ```bash git clone https://github.com/FREEZONEX/mcp-server-supos.git ``` 2. Install dependencies ```bash npm ci ``` 3. Build ```bash npm run build ``` 4. Modify the configuration in `claude_desktop_config.json` and restart the application ```json { "mcpServers": { "supos": { "command": "node", "args": [ "//dist//index.js" ], "env": { "SUPOS_API_KEY": "", "SUPOS_API_URL": "", "SUPOS_MQTT_URL": "" } } } } ``` ### Conclusion That's the complete tutorial for using this service. After successful configuration, you can see the corresponding services and tools in the following panels: ![alt text](./public/image-2.png) ![alt text](./public/image-3.png) ![alt text](./public/image-4.png) ### Installing via Smithery To install supOS MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@FREEZONEX/mcp-server-supos): ```bash npx -y @smithery/cli install @FREEZONEX/mcp-server-supos --client claude ``` ### Final Note [supOS Community Edition](https://supos-demo.supos.app/) has integrated the [open-mcp-client](https://github.com/CopilotKit/open-mcp-client) open-sourced by `CopilotKit` authors, and built-in the `mcp-server-supos` service, supporting ts version `agent`. The source code can be accessed at [supOS-CE-McpClient](https://github.com/FREEZONEX/supOS-CE-McpClient). ## License This project is licensed under the Apache License 2.0 - see the [LICENSE](./LICENSE) file for details. [readme-zh-link]: ./README-zh.md2a:T5c6,## What is supOS MCP Server? The supOS MCP Server is a server developed based on the Model Context Protocol (MCP) that provides a TypeScript SDK for clients supporting the MCP protocol. It allows clients to access various open APIs of supOS, such as querying topic tree structures and topic details. ## How to use supOS MCP Server? To use the supOS MCP Server, you need to install a compatible client like 'Claude for Desktop' and c

supOS MCP Server

Tools