영어 | 중국어

supOS MCP 서버

Name: supOS MCP Server
Author: FREEZONEX

대장간 배지

이 MCP 서버는 Model Context Protocol(MCP) 프로토콜이 제공하는 typescript-sdk 기반으로 개발되었으며, MCP 프로토콜을 지원하는 모든 클라이언트가 사용할 수 있습니다.

주제 트리 구조, 주제 세부 정보 등을 쿼리하는 등 일련의 supOS 오픈 API를 제공합니다.

지원되는 API

도구

get-model-topic-tree
- 쿼리 주제 트리 구조 메뉴 데이터
- 입력:
  - key (문자열): 자식 노드에 대한 퍼지 검색 키워드
  - showRec (부울): 표시할 레코드 수
  - type (문자열): 검색 유형: 1--텍스트 검색, 2--태그 검색
- 반환: 주제 트리 구조 메뉴 데이터
get-model-topic-detail
- 특정 주제에 대한 세부 정보를 얻으세요
- 입력:
  - topic (문자열): 모델에 해당하는 주제 경로
- 반환: 특정 주제에 대한 세부 정보
get-topic-realtime-data
- 특정 주제에 대한 실시간 데이터를 얻으세요
- 입력:
  - topic (문자열): 모델에 해당하는 주제 경로
- 반환: 특정 주제의 실시간 데이터
get-all-topic-realtime-data
- 모든 주제의 실시간 데이터를 수집하고 분석합니다.
- 반환: 모든 주제의 실시간 데이터
get-topic-history-data-by-graphql
- graphql에서 특정 주제의 기록 데이터 가져오기
- 입력:
  - topic (문자열): 모델에 해당하는 주제 경로
  - limit (숫자): 레코드 수 제한
  - startTime (문자열): ISO 8601 형식의 시작 시간(예: 2025-04-13T00:00:00Z). 지정하지 않으면 현재 시간으로부터 1주일 전으로 기본 설정됩니다.
  - endTime : ISO 8601 형식의 종료 시간(예: 2025-04-20T23:59:59Z). 지정하지 않으면 현재 시간이 기본값으로 사용됩니다.
- 반환: 특정 주제의 기록 데이터

설명서를 따라 사용을 시작해 보겠습니다.

Related MCP server: supabase-mcp

시작하기

시스템 요구 사항

노드.js

클라이언트 설치

현재 MCP 프로토콜을 지원하는 클라이언트가 많이 있습니다. 예를 들어 Claude for Desktop 과 같은 데스크톱 애플리케이션이나 Cline for VSCode 와 같은 IDE 플러그인이 있습니다. 지원되는 클라이언트에 대한 자세한 내용은 Model Context Protocol Client를 참조하세요.

여기에서는 Claude for Desktop 예로 들어보겠습니다.

데스크톱용 Claude를 다운로드하세요.
Claude for Desktop 필요한 MCP 서버를 구성합니다.
- 텍스트 편집기에서 Claude for Desktop 구성을 엽니다: ~/Library/Application Support/Claude/claude_desktop_config.json .
- File -> Setting -> Developer 에서 Edit Config 클릭하여 이 구성 파일 위치를 찾을 수도 있습니다.
- 구성 파일을 연 후 claude_desktop_config.json 에 다음 내용을 추가하고 애플리케이션을 다시 시작합니다.
  참고: 이 구성 파일을 수정할 때마다 변경 사항을 적용하려면 애플리케이션을 다시 시작해야 합니다.
  지엑스피1
- 여기서 API_URL 은 supOS Community Edition 의 접근 가능한 주소입니다. API_KEY Community Edition에 로그인하여 DataModeling -> View specific topic details -> Data Operation -> Fetch 로 이동한 후 해당 ApiKey를 복사하여 찾을 수 있습니다. MQTT_URL``UNS -> MqttBroker -> Listeners 에서 구독 가능한 주소를 확인하여 찾을 수 있습니다.

참고: 위의 MCP 서버 구성은

로컬 서비스 실행

다음 두 가지 방법 중 하나를 선택하세요.

mcp-server-supos 로컬에 설치하고 노드를 통해 실행하세요.

설치하다

npm install mcp-server-supos -g

설치된 패키지 경로를 찾으세요. 예: "C://Users//<USER_NAME>//AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js"
claude_desktop_config.json 의 구성을 수정하고 애플리케이션을 다시 시작하세요.

{ "mcpServers": { "supos": { "command": "node", "args": [ "C://Users//<USER_NAME>//AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js" ], "env": { "SUPOS_API_KEY": "<API_KEY>", "SUPOS_API_URL": "<API_URL>", "SUPOS_MQTT_URL": "<MQTT_URL>" } } } }

저장소 소스 코드를 로컬로 다운로드하고 컴파일합니다.

저장소를 복제합니다.

git clone https://github.com/FREEZONEX/mcp-server-supos.git

종속성 설치

npm ci

짓다

npm run build

claude_desktop_config.json 의 구성을 수정하고 애플리케이션을 다시 시작하세요.

{ "mcpServers": { "supos": { "command": "node", "args": [ "<local project path>//dist//index.js" ], "env": { "SUPOS_API_KEY": "<API_KEY>", "SUPOS_API_URL": "<API_URL>", "SUPOS_MQTT_URL": "<MQTT_URL>" } } } }

결론

이 서비스 사용에 대한 전체 튜토리얼은 여기까지입니다. 구성을 성공적으로 마치면 다음 패널에서 해당 서비스와 도구를 확인할 수 있습니다.
대체 텍스트

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 supOS MCP 서버를 자동으로 설치하려면:

npx -y @smithery/cli install @FREEZONEX/mcp-server-supos --client claude

마지막 메모

supOS Community Edition은 CopilotKit 개발자들이 오픈소스로 개발한 open-mcp-client를 통합하고, ts 버전 agent 지원하는 mcp-server-supos 서비스를 내장했습니다. 소스 코드는 supOS-CE-McpClient 에서 확인할 수 있습니다.