# MCP Store Greeting 서버

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

## 프로젝트 구조

```
.
├── mcp-server/          # MCP 서버 (Fastify)
├── admin-web/           # 관리자 웹 (React + Vite)
├── supabase/            # DB 스키마
└── README.md
```

## 설정

### 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`

**자세한 설정 방법은 `SUPABASE_SETUP.md` 파일 참조**

### 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](https://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`

## 로컬 개발 환경 실행

### 의존성 설치

```bash
npm run install:all
```

### MCP 서버 실행

```bash
npm run dev:mcp
# 또는
cd mcp-server && npm run dev
```

### 관리자 웹 실행

```bash
npm run dev:admin
# 또는
cd admin-web && npm run dev
```

## MCP Tool 사용

### 엔드포인트

`POST /rpc/greet_store`

### 요청

```json
{
  "store_name": "A업체"
}
```

### 응답

```json
{
  "greeting": "반갑습니다, 고객님! A업체입니다.",
  "weather_summary": "A업체(서울시 강남구)는 지금 현재 구름 많음, 23°C"
}
```

## 테스트 방법

### Render.com 배포 서버 테스트

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

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

```bash
curl https://your-app.onrender.com/health
```

### 2. greet_store 엔드포인트 테스트

**방법 1: curl 사용**

```bash
curl -X POST https://your-app.onrender.com/rpc/greet_store \
  -H "Content-Type: application/json" \
  -d '{"store_name": "테스트업체"}'
```

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

```bash
# Node.js 버전
node test-mcp-server.js https://your-app.onrender.com 테스트업체

# Bash 버전 (Linux/Mac/Git Bash)
bash test-mcp-server.sh https://your-app.onrender.com 테스트업체
```

**방법 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):

```json
{
  "store_name": "등록한업체명"
}
```

### 로컬 개발 서버 테스트

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

### 3. 예상 응답 예시

```json
{
  "greeting": "반갑습니다, 고객님! 테스트업체입니다.",
  "weather_summary": "테스트업체(서울시 강남구)는 지금 현재 맑음, 25°C"
}
```

## 관리자 웹

- 로컬: http://localhost:5173
- Supabase Auth로 로그인
- 업체 등록 시 주소 자동완성 및 지도에서 위치 선택
- 저장 시 lat/lng 자동 계산 및 저장