supOS MCP Server

英語|中国語

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）。指定しない場合は、現在の時刻がデフォルトとなります。
   • 戻り値: 特定のトピックの履歴データ

ドキュメントに従って使い始めましょう

はじめる

システム要件

• 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. インストール

2. インストールされたパッケージのパスを見つけます。例: "C://Users//<USER_NAME>//AppData//Roaming//npm//node_modules//mcp-server-supos//dist//index.js"
3. claude_desktop_config.jsonの設定を変更し、アプリケーションを再起動します。

• リポジトリのソースコードをダウンロードしてローカルにコンパイルする

1. リポジトリをクローンします。

2. 依存関係をインストールする

3. 建てる

4. claude_desktop_config.jsonの設定を変更し、アプリケーションを再起動します。

結論

このサービスの使い方に関するチュートリアルは以上です。設定が完了すると、以下のパネルに対応するサービスとツールが表示されます。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の supOS MCP Server を自動的にインストールするには:

最終ノート

supOS Community Editionは、 CopilotKit作者によってオープンソース化されたopen-mcp-clientを統合し、tsバージョンagentをサポートするmcp-server-suposサービスを内蔵しています。ソースコードはsupOS-CE-McpClientからアクセスできます。

ライセンス

このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。