ultra/mcp-ss は、Web 表示サービスである smartscreen.tv と統合された FastAPI ベースの MCP サーバーであり、単純な HTTP/MCP コマンドを使用してプログラムで画面を操作 (メディアの表示、通知の送信、再生の制御など) できます。

目次

• SmartScreenとは何ですか?

• 前提条件

• 構成

• ローカルで実行

• ドッカー

• APIエンドポイント

  • 健康と検索

  • SmartScreen コマンド (HTTP)

• MCPツール統合

• SSEをサポートしていないクライアントにMCPプロキシを使用する

• Langflow での MCP-SS の設定

• 貢献

Related MCP server: Computer Control MCP

SmartScreenとは何ですか?

SmartScreen は Web ベースのスクリーニング サービスです。
複数のディスプレイや場所にまたがるコンテンツをリモートで制御できます。MCPツールをAIアプリに追加するだけです。

SmartScreen のセットアップ:

1. URL: smartscreen.tv から SmartScreen にアクセスします。
   

   • Linux では、SmartScreen は snapcraft 経由でインストールできます。

2. 左上隅のメニューボタンをクリックして**「設定」**にアクセスします。ここで、デバイスに名前を付けたり、タグを追加したり、OnStartやその他のスケジュールされたイベントを設定したりできます。
   

   • 変更を加えた後は必ず「保存」をクリックしてください。

3. SmartScreenをクリックすると、ホームページに戻ります。

ウルトラ/MCP-SS

前提条件

• Python 3.12以上

• Docker（オプション、コンテナ化されたデプロイメント用）

• 「YouTube Data API v3」用にGoogle Consoleから設定されたYOUTUBE_API_KEY

• SS_SERVICE_TOKEN環境変数

構成

.envファイルを作成するか、環境変数をエクスポートします。

• YOUTUBE_API_KEY – Google YouTube Data API v3 キー

• SS_SERVICE_TOKEN – SmartScreen サービストークン

例.env :

YOUTUBE_API_KEY=AIzaSy...
SS_SERVICE_TOKEN=xxxxx

またはエクスポートします:

export YOUTUBE_API_KEY=AIzaSy...
export SS_SERVICE_TOKEN=xxxxx

ローカルで実行

uvicorn main:app --reload --host 0.0.0.0 --port 8000

ドッカー

docker build -t ultra-mcp-ss .
docker run -d --name ultra-mcp-ss -p 127.0.0.1:8000:8000 ultra-mcp-ss

APIエンドポイント

ベース URL: http://127.0.0.1:8000

健康と検索

• HEAD /mcp – MCPのヘルスチェック

• GET /search-youtube?query=... – 最も関連性の高いYouTube動画のURLを返します

SmartScreen コマンド (HTTP)

リクエスト/レスポンス スキーマについては、 http://<host>:8000/docsにある OpenAPI ドキュメントを参照してください。

MCPツール統合

FastApiMCP は、すべてのエンドポイントを/mcpの下に MCP ツールとして自動的にマウントします。
MCP クライアントを使用して、名前 (例: drop 、 notify 、 toastなど) でツールを呼び出します。

SSE サポートのないクライアントに MCP プロキシを使用する (Claude Desktop)

1. mcp-proxy をインストールします。

   uv pip install --user mcp-proxy #for Python
   npm install -g mcp-proxy #for Node.js
   pnpm add -g mcp-proxy #for Node.js
    

2. Windowsの場合:
   claude_desktop_config.jsonを編集します。

   {
     "mcpServers": {
       "ultra-mcp-ss": {
         "command": "mcp-proxy",
         "args": ["http://0.0.0.0:8000/mcp"]
       }
     }
   }

3. MacOSの場合:
   mcp-proxyへのパスを取得します:

   which mcp-proxy

   claude_desktop_config.jsonを編集します。

   {
     "mcpServers": {
       "ultra-mcp-ss": {
         "command": "/YOUR/PATH/TO/mcp-proxy",
         "args": ["http://0.0.0.0:8000/mcp"]
       }
     }
   }

Langflow での MCP-SS の設定

ultra-mcp-ss を Langflow と統合するには:

1. LangflowのツールセクションからMCPサーバーコンポーネントを追加します。

2. コンポーネント設定でツールモードを有効にする

3. リアルタイム通信にはSSEモードを選択してください

4. MCP SSE URL を入力します: http://0.0.0.0:8000/mcp

5. Dockerを使用して実行している場合は、 http://127.0.0.1:8000使用します。

6. コンポーネントを実行して接続を確立します

接続すると、Langflow ワークフロー内ですべての SmartScreen コマンドを使用できるようになります。

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. プルリクエストを送信する

FastAPIとFastApiMCPで作成