Ultra MCP-SS

ultra/mcp-ss는 웹 디스플레이 서비스인 smartscreen.tv와 통합된 FastAPI 기반 MCP 서버로, 간단한 HTTP/MCP 명령을 통해 프로그래밍 방식으로 화면을 조작(예: 미디어 표시, 알림 보내기, 재생 제어)할 수 있습니다.

목차

• SmartScreen이란 무엇인가요?
• 필수 조건
• 구성
• 지역적으로 실행
• 도커
• API 엔드포인트
  • 건강 및 검색
  • SmartScreen 명령(HTTP)
• MCP 도구 통합
• SSE 지원이 없는 클라이언트에 MCP 프록시 사용
• Langflow에서 MCP-SS 설정하기
• 기여하다

SmartScreen이란 무엇인가요?

SmartScreen은 웹 기반 스크리닝 서비스입니다.
여러 디스플레이와 위치에 있는 콘텐츠를 원격으로 제어할 수 있습니다. AI 앱에 MCP 도구를 추가하기만 하면 됩니다.

SmartScreen 설정:

1. URL: smartscreen.tv를 통해 SmartScreen에 접속하세요.
   
   • Linux에서는 Snapcraft를 통해 SmartScreen을 설치할 수 있습니다.
2. 왼쪽 상단의 메뉴 버튼을 클릭하여 설정 으로 이동합니다. 여기에서 기기 이름을 지정하고, 태그를 추가하고, OnStart 및 기타 예약 이벤트를 설정할 수 있습니다.
   
   • 변경 사항을 적용한 후에는 "저장"을 클릭하는 것을 잊지 마세요.
3. 홈페이지로 돌아가려면 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)

요청/응답 스키마에 대한 자세한 내용은 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 설정하기

Langflow와 ultra-mcp-ss를 통합하려면:

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로 제작됨