ultra/mcp-ss は、Web 表示サービスである smartscreen.tv と統合された FastAPI ベースの MCP サーバーであり、単純な HTTP/MCP コマンドを使用してプログラムで画面を操作 (メディアの表示、通知の送信、再生の制御など) できます。
目次
Related MCP server: Computer Control MCP
SmartScreenとは何ですか?
SmartScreen は Web ベースのスクリーニング サービスです。
複数のディスプレイや場所にまたがるコンテンツをリモートで制御できます。MCPツールをAIアプリに追加するだけです。
SmartScreen のセットアップ:
URL: smartscreen.tv から SmartScreen にアクセスします。
Linux では、SmartScreen は snapcraft 経由でインストールできます。
左上隅のメニューボタンをクリックして**「設定」**にアクセスします。ここで、デバイスに名前を付けたり、タグを追加したり、OnStartやその他のスケジュールされたイベントを設定したりできます。
変更を加えた後は必ず「保存」をクリックしてください。
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 :
またはエクスポートします:
ローカルで実行
ドッカー
APIエンドポイント
ベース URL: http://127.0.0.1:8000
健康と検索
HEAD /mcp– MCPのヘルスチェックGET /search-youtube?query=...– 最も関連性の高いYouTube動画のURLを返します
SmartScreen コマンド (HTTP)
終点 | 説明 |
POST /ドロップ | メディアURLを画面フレームにドロップする |
POST /通知 | 通知バナーを送信する |
POST /トースト | トーストポップアップメッセージを表示する |
POST /マーキー | スクロールするマーキーテキストを表示する |
POST /テキスト | 静的テキストオーバーレイをレンダリングする |
POST /app | フレーム内でウェブアプリを起動する |
POST /タッチ | 再生/制御コマンドを送信する |
POST /ステータス | システムステータスの照会または設定 |
ポスト/dj | DJ タスクの実行: スケジュール、キオスク、再起動、ロゴ |
リクエスト/レスポンス スキーマについては、 http://<host>:8000/docsにある OpenAPI ドキュメントを参照してください。
MCPツール統合
FastApiMCP は、すべてのエンドポイントを/mcpの下に MCP ツールとして自動的にマウントします。
MCP クライアントを使用して、名前 (例: drop 、 notify 、 toastなど) でツールを呼び出します。
SSE サポートのないクライアントに MCP プロキシを使用する (Claude Desktop)
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.jsWindowsの場合:
claude_desktop_config.jsonを編集します。{ "mcpServers": { "ultra-mcp-ss": { "command": "mcp-proxy", "args": ["http://0.0.0.0:8000/mcp"] } } }MacOSの場合:
mcp-proxyへのパスを取得します:which mcp-proxyclaude_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 と統合するには:
LangflowのツールセクションからMCPサーバーコンポーネントを追加します。
コンポーネント設定でツールモードを有効にする
リアルタイム通信にはSSEモードを選択してください
MCP SSE URL を入力します:
http://0.0.0.0:8000/mcpDockerを使用して実行している場合は、
http://127.0.0.1:8000使用します。コンポーネントを実行して接続を確立します
接続すると、Langflow ワークフロー内ですべての SmartScreen コマンドを使用できるようになります。
貢献
リポジトリをフォークする
機能ブランチを作成する
プルリクエストを送信する
FastAPIとFastApiMCPで作成