lumei-lamp MCP

LUMEI 가상 조명을 Claude ↔ MCP ↔ 브라우저 방식으로 원격 조작하는 프로젝트입니다.

구조

Claude (claude.ai)
   │  MCP tool 호출
   ▼
Cloudflare Workers  (/mcp)
   │  상태를 KV에 저장
   ▼
Cloudflare KV  ("state" 키)
   ▲  2초마다 폴링
   │
브라우저 (virtual.html)

제공 MCP Tools

Tool	설명
get_product_info	제품 정보 조회
get_lamp_state	현재 상태 조회 (전원·밝기·모드·배터리·추적 여부)
get_charging_state	배터리 잔량 조회
set_power	전원 ON/OFF
set_brightness	밝기 절댓값 설정 (0~100)
set_mode	조명 모드 변경 (focus / relax / night)
set_tracking	물체 추적 ON/OFF
send_message	Push Messages 패널에 메시지 전송

시작하기

1. 브랜드 웹페이지 제작 (✏️ 핵심 수정 파일)

index.html을 팀의 브랜드 페이지로 교체하세요. 현재는 placeholder가 들어 있습니다.

GitHub Pages 주소: https://{GitHub 유저명}.github.io/lumei-lamp/

제품 정보도 함께 수정 — virtual.html 안의 <script id="product-info"> 블록을 팀 기획에 맞게 편집하세요.

{
  "name": "LUMEI",
  "tagline": "빛이 피사체를 찾아가는 조명입니다.",
  "description": "...",
  "features": ["물체 자동 추적", "..."],
  "spec": { "battery": "8시간", "price": "79,000원" }
}

Claude가 제품 정보를 물어보면 이 JSON을 읽어서 답합니다.

2. GitHub Pages 활성화

레포 Settings → Pages → Branch: main, folder: / (root)

virtual.html 접속 주소: https://{GitHub 유저명}.github.io/lumei-lamp/virtual.html

3. Worker URL 설정

virtual.html 안의 MCP_WORKER_URL을 자신의 Workers 주소로 교체하세요.

const MCP_WORKER_URL = "https://lumei-lamp.{계정명}.workers.dev";

src/index.ts 안의 VIRTUAL_DEVICE_URL도 교체하세요.

const VIRTUAL_DEVICE_URL =
  "https://{GitHub 유저명}.github.io/lumei-lamp/virtual.html";

4. claude.ai 커넥터 연결

Settings → Integrations → Add custom integration URL: https://lumei-lamp.{계정명}.workers.dev/mcp

사용 예시 (Claude에게 말하기)

• "lumei 전원 켜줘"
• "포커스 모드로 바꿔줘"
• "밝기 80으로 올려줘"
• "물체 추적 켜줘"
• "지금 상태 알려줘"
• "배터리 얼마나 남았어?"
• "조명에 '안녕하세요!' 메시지 보내줘"
• "이 제품 어떤 제품이야?"