Ultra MCP-SS

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

目次

• SmartScreenとは何ですか?
• 前提条件
• 構成
• ローカルで実行
• ドッカー
• APIエンドポイント
  • 健康と検索
  • SmartScreen コマンド (HTTP)
• MCPツール統合
• SSEをサポートしていないクライアントにMCPプロキシを使用する
• Langflow での MCP-SS の設定
• 貢献

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 :

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

ローカルで実行

ドッカー

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で作成