英語|中国語

supOS MCP サーバー

この MCP サーバーは、 Model Context Protocol (MCP)プロトコルによって提供されるtypescript-sdkに基づいて開発されており、MCP プロトコルをサポートするすべてのクライアントが使用できます。

トピックツリー構造やトピックの詳細などのクエリなど、一連の supOS オープン API を提供します。

サポートされているAPI

ツール

1. get-model-topic-tree

   • トピックツリー構造メニューデータのクエリ

   • 入力：

     • key (文字列): 子ノードのあいまい検索キーワード

     • showRec (boolean): 表示するレコード数

     • 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

はじめる

システム要件

• Node.js

クライアントのインストール

現在、 Claude for Desktopようなデスクトップアプリケーションや、IDEプラグイン（ VSCode用のClineプラグインなど）など、MCPプロトコルをサポートするクライアントは数多くあります。サポートされているクライアントの詳細については、 Model Context Protocol Clientをご覧ください。

ここではClaude for Desktop例として使用します。

• Claude for Desktopをダウンロードしてください。

• Claude for Desktopに必要な MCP サーバーを構成します。

• • テキスト エディターでClaude for Desktop構成を開きます: ~/Library/Application Support/Claude/claude_desktop_config.json 。

• • この構成ファイルの場所はFile -> Setting -> DeveloperのEdit Configをクリックして見つけることもできます。

• • 構成ファイルを開いたら、 claude_desktop_config.jsonに次の内容を追加し、アプリケーションを再起動します。
    注意: 変更を有効にするには、この構成ファイルを変更するたびにアプリケーションを再起動する必要があります。

    {
      "mcpServers": {
        "supos": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-server-supos"
          ],
          "env": {
            "SUPOS_API_KEY": "<API_KEY>",
            "SUPOS_API_URL": "<API_URL>",
            "SUPOS_MQTT_URL": "<MQTT_URL>"
          }
        }
      }
    }

• • API_URLsupOS Community Editionのアクセス可能なアドレスです。API_KEY API_KEY 、コミュニティエディションにログインし、 DataModeling -> View specific topic details -> Data Operation -> Fetchに移動して、対応する ApiKey をコピーすることで確認できます。MQTT_URL MQTT_URL``UNS -> MqttBroker -> Listenersにアクセスして、サブスクライブ可能なアドレスを表示することで確認できます。

注: 上記のMCPサーバーの構成では、 npxを使用してmcp-server-supos npmパッケージをプルし、ローカルで実行してクライアントにサービスを提供しています。ただし、 Windowsシステムではnpxが環境変数env設定の読み取りに問題が発生する可能性があるため、以下の解決策を採用できます。

ローカルでサービスを実行する

次の 2 つの方法のいずれかを選択します。

• 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 Server を自動的にインストールするには:

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ファイルを参照してください。