LIFX MCP Server

LIFX MCP 서버

LIFX 공식 HTTP API를 통해 LIFX 스마트 조명을 제어하는 TypeScript 기반 MCP 서버입니다.

특징

• MCP 도구를 사용하여 LIFX 조명 제어
• 상태 설정, 토글 및 효과 적용(호흡, 이동, 변형, 화염)
• 장면을 활성화하고 색상 문자열을 구문 분석합니다.
• 간편한 통합을 위해 FastMCP 로 구축됨

시작하기

필수 조건

• Node.js(v16 이상 권장)
• LIFX Cloud API 토큰( 여기서 받으세요 )
• MCP 호환 클라이언트(예: VS Code)

설치

지엑스피1

짓다

달리다

서버를 직접 시작할 수 있습니다:

또는 MCP 툴을 사용하세요(권장):

VS Code를 사용한 사용

빠른 설치를 위해 이 README 상단의 원클릭 설치 버튼 중 하나를 사용하세요.

수동 설치의 경우, VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.

원하는 경우, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.

.vscode/mcp.json 파일에는 mcp 키가 필요하지 않습니다.

구성

서버에는 LIFX API 토큰이 필요합니다. 다음을 통해 제공할 수 있습니다.

• .env 파일:
  LIFX_TOKEN=your_lifx_token_here
• 또는 VS Code MCP 확장 프롬프트를 통해 가능합니다(참조 .vscode/mcp.json ).

용법

서버는 다음과 같은 MCP 도구를 제공합니다.

• get-lights : 선택자를 통해 조명 상태 가져오기
• set-state : 상태 설정(전원, 색상, 밝기 등)
• set-states : 여러 상태를 한 번에 설정
• set-state-delta : 델타 변경 사항 적용
• toggle-lights : 전원 토글
• breathe-effect , move-effect , morph-effect , flame-effect : 달리기 효과
• get-scenes , activate-scene : 장면 관리
• parse-color : 색상 문자열 구문 분석

예: 조명 전환

개발

• TypeScript 소스: src/
• 빌드 출력: build/
• 유형 및 스키마: src/types.ts
• FastMCP 서버: src/index.ts

스크립트

• npm run build – TypeScript를 컴파일하여 build/
• npm start – 컴파일된 서버 실행
• npm run dev – 개발을 위해 tsx로 실행
• npm run inspect – FastMCP Inspector로 검사

API 참조

전체 LIFX API 세부 정보와 색상 형식은 .docs/lifxapi.md 참조하세요.

특허

아이에스씨

이 프로젝트는 LIFX와 제휴 관계가 없습니다. 사용 시 모든 책임은 사용자에게 있습니다.