충전비교 MCP 서버

한국 전기차 충전 요금을 카드별로 비교하고 최저가를 찾아주는 충전비교 서비스의 MCP 서버입니다. PlayMCP in KC(카카오클라우드) 배포용 — stateless Streamable HTTP, 세션 미발급.

MCP TypeScript SDK v2 (2026-07-28 스펙) 기반. stateless 모드가 신규(2026-07-28)와 구(2025) 클라이언트를 같은 /mcp 엔드포인트에서 모두 서빙합니다 (@modelcontextprotocol/server + @modelcontextprotocol/node).

툴 (7개)

• getProviders — 충전 사업자 목록

• getCards — 할인 카드 목록

• getChargerTypes — 충전기 종류 코드

• calculatePrices — 사업자·충전기 종류별 전체 카드 요금 비교

• compareMyPrices — 보유 카드(cardNames)만으로 요금 비교

• getCardCoverage — 카드별 지원 사업자 커버리지 분석

• searchProvidersByAddress — 주소/장소명 주변 충전 사업자 검색

PlayMCP in KC 등록 값

환경변수 (필수)

• SUPABASE_URL — Supabase 프로젝트 URL

• SUPABASE_ANON_KEY — Supabase anon 키 (시크릿 권장)

• KAKAO_API_KEY — Kakao REST API 키 (시크릿 권장; 지오코딩·주변 검색용)

• PORT — 기본 8000

콘솔에 환경변수 설정이 없다면 컨테이너 /app/.env 파일도 읽는다 (process.loadEnvFile).

로컬 실행

npm install
npm run build
SUPABASE_URL=... SUPABASE_ANON_KEY=... KAKAO_API_KEY=... npm start

Docker

docker build -t evcharger-mcp-kc .
docker run -p 8000:8000 -e SUPABASE_URL=... -e SUPABASE_ANON_KEY=... -e KAKAO_API_KEY=... evcharger-mcp-kc

확인

curl http://localhost:8000/health
curl -X POST http://localhost:8000/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'