英語|中国語

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 (boolean): 表示するレコード数
  - 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

はじめる

システム要件

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サーバーの構成では、

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

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

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 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からアクセスできます。