Calcifier

실내 캠핑용 스마트 걸이 램프 Calcifier의 MCP 서버 및 가상 디바이스 쇼룸 프로젝트입니다. Claude와의 대화로 램프를 제어하고, 브라우저 쇼룸에 실시간으로 반영됩니다.

파일 구조

calcifier/
├── index.html              ← 브랜드 웹페이지 (GitHub Pages 진입점)
├── calcifier.html          ← 가상 디바이스 쇼룸 (MCP 연동 목업)
├── sound.mp3               ← 장작 모닥불 사운드
├── src/
│   └── index.ts            ← MCP 서버 본체 (Cloudflare Workers)
├── wrangler.toml           ← Cloudflare Workers 배포 설정
├── package.json
├── tsconfig.json
└── .github/
    └── workflows/
        └── deploy.yml      ← GitHub Actions 자동 배포

Related MCP server: Claude-LMStudio-Bridge

학생 작업 순서

1단계 — claude.ai 커스텀 커넥터 연결

1. claude.ai → Settings → Integrations → Add custom integration

2. URL 입력: https://calcifier.typica-918.workers.dev/mcp

3. OAuth 인증 팝업 → 허용

4. 도구 목록에서 아래 9개 tool이 보이면 연결 성공

2단계 — index.html 브랜드 페이지 작성

index.html을 팀의 브랜드 웹페이지로 자유롭게 작성하세요. 폰트, 컬러, 레이아웃 등 디자인 방향은 팀이 직접 결정합니다. GitHub Pages를 통해 https://{계정명}.github.io/{레포명}/으로 퍼블리싱됩니다.

3단계 — calcifier.html 룩앤필 수정

calcifier.html의 디자인을 자신이 작성한 index.html의 스타일과 일치하도록 수정하세요. 폰트, 컬러, 타이포그래피 등을 맞추어 두 페이지가 같은 브랜드처럼 보이게 합니다. 전체 레이아웃이나 기능 로직은 수정하지 않아도 됩니다.

4단계 — 쇼룸에서 MCP 연동 확인

calcifier.html을 브라우저에서 열고 하단 MCP Worker URL 입력창에 아래 주소를 입력하세요.

https://calcifier.typica-918.workers.dev

⚠️ 주의: URL 끝에 /를 붙이지 마세요. 끝에 /가 있으면 /state 폴링 경로가 //state로 잘못 조합되어 연결에 실패합니다. 올바른 예: https://calcifier.typica-918.workers.dev 잘못된 예: https://calcifier.typica-918.workers.dev/

실시간 폴링 시작 버튼을 누른 뒤, Claude에게 자연어로 명령해보세요.

"잘게."            → 취침 모드
"책 읽을게."       → 독서 모드
"밝기 50%로 해줘." → 밝기 조절
"충전해줘."        → 배터리 100%

자주 발생하는 오류