영어 | 중국어

supOS MCP 서버

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

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

지원되는 API

도구

1. get-model-topic-tree

   • 쿼리 주제 트리 구조 메뉴 데이터

   • 입력:

     • key (문자열): 자식 노드에 대한 퍼지 검색 키워드

     • showRec (부울): 표시할 레코드 수

     • type (문자열): 검색 유형: 1--텍스트 검색, 2--태그 검색

   • 반환: 주제 트리 구조 메뉴 데이터

2. get-model-topic-detail

   • 특정 주제에 대한 세부 정보를 얻으세요

   • 입력:

     • topic (문자열): 모델에 해당하는 주제 경로

   • 반환: 특정 주제에 대한 세부 정보

3. get-topic-realtime-data

   • 특정 주제에 대한 실시간 데이터를 얻으세요

   • 입력:

     • topic (문자열): 모델에 해당하는 주제 경로

   • 반환: 특정 주제의 실시간 데이터

4. get-all-topic-realtime-data

   • 모든 주제의 실시간 데이터를 수집하고 분석합니다.

   • 반환: 모든 주제의 실시간 데이터

5. 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 서버 구성은 npx 사용하여 mcp-server-supos npm 패키지를 가져오고 로컬에서 실행하여 클라이언트에 서비스를 제공합니다. 그러나 npx Windows 시스템에서 환경 변수 env 구성을 읽는 데 문제가 있을 수 있으므로 다음 해결책을 적용할 수 있습니다.

로컬 서비스 실행

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

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

1. 설치하다

npm install mcp-server-supos -g

2. 설치된 패키지 경로를 찾으세요. 예: "C://Users//<USER_NAME>//AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js"

3. 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>"
      }
    }
  }
}

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

1. 저장소를 복제합니다.

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

2. 종속성 설치

npm ci

3. 짓다

npm run build

4. 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 에서 확인할 수 있습니다.

특허

이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.