MCP Store Greeting 서버

업체 환영 인사 + 날씨 정보를 제공하는 MCP 서버 및 관리자 웹

프로젝트 구조

설정

1. Supabase 설정

1. Supabase 프로젝트 생성

2. 테이블 생성 (중요!):

   • Supabase 대시보드 → SQL Editor 메뉴

   • New Query 클릭

   • supabase/schema.sql 파일의 내용을 복사하여 붙여넣기

   • Run 버튼 클릭하여 실행

   • 성공 메시지 확인

   • Table Editor에서 stores 테이블이 생성되었는지 확인

3. 이메일 확인 비활성화 (개발 환경 권장):

   • Supabase 대시보드 → Authentication → Settings

   • "Enable email confirmations" 체크 해제

   • 또는 "Confirm email"을 "Off"로 설정

4. 환경 변수 설정:

   • mcp-server/.env: SUPABASE_URL, SUPABASE_SERVICE_KEY

   • admin-web/.env: VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY

자세한 설정 방법은

2. 날씨 API 키

• OpenWeather API 키 발급: https://openweathermap.org/api

• mcp-server/.env에 WEATHER_API_KEY 설정

3. 카카오 지도 API 키

• 카카오 개발자 콘솔에서 앱 키 발급

• admin-web/index.html의 YOUR_KAKAO_APP_KEY 교체

배포 (Render.com)

1. Render.com에 배포하기

사전 준비

1. Render.com 계정 생성

2. GitHub 저장소에 프로젝트 푸시 (또는 Render.com에서 직접 연결)

배포 단계

방법 1: render.yaml 사용 (권장)

1. GitHub 저장소에 render.yaml 파일이 이미 포함되어 있음

2. Render.com 대시보드 → New + → Blueprint

3. GitHub 저장소 선택

4. Render가 자동으로 render.yaml 설정을 읽어옴

5. 환경 변수 설정:

   • SUPABASE_URL: Supabase 프로젝트 URL

   • SUPABASE_SERVICE_KEY: Supabase Service Role Key

   • WEATHER_API_KEY: OpenWeather API 키

6. Apply 클릭하여 배포 시작

방법 2: 수동 설정

1. Render.com 대시보드 → New + → Web Service

2. GitHub 저장소 연결

3. 설정:

   • Name: mcp-server

   • Environment: Node

   • Build Command: cd mcp-server && npm install

   • Start Command: cd mcp-server && npm start

   • Plan: Free (또는 원하는 플랜)

4. 환경 변수 추가:

   • NODE_ENV: production

   • PORT: 10000 (Render.com이 자동 설정하지만 명시적으로 설정 가능)

   • SUPABASE_URL: Supabase 프로젝트 URL

   • SUPABASE_SERVICE_KEY: Supabase Service Role Key

   • WEATHER_API_KEY: OpenWeather API 키

5. Create Web Service 클릭

배포 후 확인

• 배포 완료 후 Render.com이 자동으로 HTTPS URL 제공 (예: https://mcp-server.onrender.com)

• Health Check: https://your-app.onrender.com/health

로컬 개발 환경 실행

의존성 설치

MCP 서버 실행

관리자 웹 실행

MCP Tool 사용

엔드포인트

POST /rpc/greet_store

요청

응답

테스트 방법

Render.com 배포 서버 테스트

배포된 서버 URL을 사용하여 테스트 (예: https://mcp-server.onrender.com)

1. Health Check (서버 상태 확인)

2. greet_store 엔드포인트 테스트

방법 1: curl 사용

방법 2: 테스트 스크립트 사용

방법 3: 브라우저에서 Health Check 브라우저에서 https://your-app.onrender.com/health 접속하여 {"status":"ok"} 응답 확인

방법 4: Postman/Insomnia 사용

• Method: POST

• URL: https://your-app.onrender.com/rpc/greet_store

• Headers: Content-Type: application/json

• Body (JSON):

로컬 개발 서버 테스트

로컬에서 실행 중인 경우 http://localhost:3000 사용

3. 예상 응답 예시

관리자 웹

• 로컬: http://localhost:5173

• Supabase Auth로 로그인

• 업체 등록 시 주소 자동완성 및 지도에서 위치 선택

• 저장 시 lat/lng 자동 계산 및 저장