ultra/mcp-ss는 웹 디스플레이 서비스인 smartscreen.tv와 통합된 FastAPI 기반 MCP 서버로, 간단한 HTTP/MCP 명령을 통해 프로그래밍 방식으로 화면을 조작(예: 미디어 표시, 알림 보내기, 재생 제어)할 수 있습니다.
목차
Related MCP server: Computer Control MCP
SmartScreen이란 무엇인가요?
SmartScreen은 웹 기반 스크리닝 서비스입니다.
여러 디스플레이와 위치에 있는 콘텐츠를 원격으로 제어할 수 있습니다. AI 앱에 MCP 도구를 추가하기만 하면 됩니다.
SmartScreen 설정:
URL: smartscreen.tv를 통해 SmartScreen에 접속하세요.
Linux에서는 Snapcraft를 통해 SmartScreen을 설치할 수 있습니다.
왼쪽 상단의 메뉴 버튼을 클릭하여 설정 으로 이동합니다. 여기에서 기기 이름을 지정하고, 태그를 추가하고, OnStart 및 기타 예약 이벤트를 설정할 수 있습니다.
변경 사항을 적용한 후에는 "저장"을 클릭하는 것을 잊지 마세요.
홈페이지로 돌아가려면 SmartScreen을 클릭하세요.
울트라/mcp-ss
필수 조건
파이썬 3.12+
Docker(컨테이너화된 배포를 위한 선택 사항)
Google 콘솔에서 "YouTube Data API v3"에 대한 YOUTUBE_API_KEY가 설정되었습니다.
SS_SERVICE_TOKEN 환경 변수
구성
.env 파일을 만들거나 환경 변수를 내보냅니다.
YOUTUBE_API_KEY – Google YouTube 데이터 API v3 키
SS_SERVICE_TOKEN – SmartScreen 서비스 토큰
예시 .env :
지엑스피1
또는 내보내세요:
지역적으로 실행
도커
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 /앱 | 프레임에서 웹 앱 실행 |
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 설정하기
Langflow와 ultra-mcp-ss를 통합하려면:
Langflow의 도구 섹션에서 MCP 서버 구성 요소를 추가합니다.
구성 요소 설정에서 도구 모드 활성화
실시간 통신을 위해 SSE 모드를 선택하세요
MCP SSE URL을 입력하세요:
http://0.0.0.0:8000/mcpDocker를 사용하여 실행하는 경우
http://127.0.0.1:8000사용하세요.연결을 설정하려면 구성 요소를 실행하세요.
연결되면 Langflow 워크플로 내에서 모든 SmartScreen 명령을 사용할 수 있습니다.
기여하다
저장소를 포크하세요
기능 브랜치 생성
풀 리퀘스트 제출
FastAPI 및 FastApiMCP로 제작됨