Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
☕ coffee-price-mcp
"오늘 커피 가장 싸게 먹는 법" — read-only MCP 서버.
An MCP server that ranks today's cheapest coffee in Korea by real out-of-pocket price (list price − telecom/card/coupon perks). Plugs into Claude Code, OpenAI Codex, and Gemini CLI in one line.
coffee.pryzm.gg 의 공개 브랜드 혜택 API(/coffeecong/brand-benefits/*)를 감싸고, 브랜드별 메뉴 정가 상수로 체감가(정가 − 할인) 를 계산해 랭킹합니다. DB·시크릿 없음 — 공개 API만 호출하는 얇은 래퍼라서 그대로 가져다 쓰면 됩니다.
🔗 소개 페이지: coffee.pryzm.gg/coffee/mcp.html · 데모: AI에 연결하고 "오늘 제일 싼 커피는?" 한마디면 끝.
🚀 빠른 연결 (설치 불필요)
세 도구 모두 아래 한 가지 실행 명령을 공유합니다:
npx -y github:jeonghwanko/coffee-price-mcpNode.js 18+ 만 있으면 됩니다. 최초 실행 시 GitHub에서 받아 자동 빌드하므로 몇 초 걸리고, 이후 캐시됩니다.
Claude Code
가장 간단 — 터미널에서:
claude mcp add coffee-price -- npx -y github:jeonghwanko/coffee-price-mcp또는 .mcp.json(프로젝트) / ~/.claude.json(전역)에 직접:
{
"mcpServers": {
"coffee-price": {
"command": "npx",
"args": ["-y", "github:jeonghwanko/coffee-price-mcp"]
}
}
}OpenAI Codex CLI
~/.codex/config.toml 에 추가:
[mcp_servers.coffee-price]
command = "npx"
args = ["-y", "github:jeonghwanko/coffee-price-mcp"]Gemini CLI
~/.gemini/settings.json 에 추가:
{
"mcpServers": {
"coffee-price": {
"command": "npx",
"args": ["-y", "github:jeonghwanko/coffee-price-mcp"]
}
}
}연결 후 "오늘 제일 싼 커피는?" 이라고 물어보면 됩니다.
📋 예시
AI에게 평소 말투로 물어보면, AI가 get_cheapest_coffee 를 호출해 이렇게 답합니다:
🙋 오늘 제일 싼 커피는?
🤖 오늘 기준 아메리카노 체감가 TOP 3예요.
🥇 할리스커피 0원 (정가 4,100) — KT VVIP, 아메리카노 2잔 무료
🥈 스타벅스 0원 (정가 4,500) — LG U+ VVIP/VIP, 1잔 무료
🥉 컴포즈커피 1,000원 (정가 1,500) — 조건 없음, 누구나
👉 멤버십이 없다면 컴포즈 1,000원이 사실상 최저가예요.멤버십/카드를 알려주면 본인이 받을 수 있는 혜택만 골라 다시 랭킹합니다:
🙋 나 SKT랑 현대카드 있어. 오늘 라떼 싸게 마시려면?🛠 Tools (모두 read-only)
| tool | 설명 | 주요 인자 |
|---|---|---|
get_cheapest_coffee | 오늘 가장 싸게 먹을 수 있는 커피 TOP N. 체감가 오름차순. | memberships, menu, brands, limit |
search_coffee_deals | 혜택 검색/필터. 각 혜택에 체감가 주석. | query, brand, provider, benefitType, todayOnly |
verify_receipt_price | 내가 낸 가격 적정성 점검 → great/fair/overpaid + 더 나은 혜택 제시. | brand, paidPrice, menu |
get_card_benefits | 카드사·통신사·페이별 혜택 모아보기. 즉시 할인은 체감가로, 캐시백·적립은 정보성으로 노출. | card, brand, limit |
지원 브랜드: starbucks, mega, compose, twosome, coffeebean, bluebottle, hollys, ediya, paik, theventi, gongcha
🧮 체감가 엔진 (src/pricing.ts)
실데이터상 discountPct가 거의 항상 null이라 제목 텍스트 파싱이 핵심입니다:
- 명시적
discountPct→정가 × (1 − pct/100)(신뢰도 high) - 무료 음료 ('음료' 인접 '무료/증정') → 0원
- 퍼센트 ("최대 20%")
- BOGO ("1+1", "2+1") → 음료당 환산
- 정액 ("500원 할인")
- 산정 불가 → 랭킹 제외
원두·MD·굿즈 등 음료가 아닌 대상의 할인은 제외합니다(제목 가드). 마케팅 요약은 오탐이 잦아 파싱에서 제외.
⚠️ 체감가는 정가(코드 상수) − 혜택(제목 파싱) 추정치입니다. 등급·선착순·중복 불가 등 실제 적용 조건은 각 혜택의 sourceUrl 을 확인하세요. 정가는 2026 기준 근사값입니다.⚙️ 환경변수
| 변수 | 기본값 | 설명 |
|---|---|---|
COFFEE_API_BASE | https://coffee.pryzm.gg/api | 혜택 API 베이스. 로컬 개발 시 http://localhost:4000 |
config의 env 블록으로 덮어쓸 수 있습니다:
{
"command": "npx",
"args": ["-y", "github:jeonghwanko/coffee-price-mcp"],
"env": { "COFFEE_API_BASE": "https://coffee.pryzm.gg/api" }
}🧑💻 로컬 개발
git clone https://github.com/jeonghwanko/coffee-price-mcp.git
cd coffee-price-mcp
npm install
npm run build # tsc → dist/
npm test # vitest (pricing/engine 테스트)
npm start # node dist/index.js (stdio)소스에서 직접 실행하도록 config를 바꾸려면:
{ "command": "node", "args": ["/절대/경로/coffee-price-mcp/dist/index.js"] }📦 npm 게시 (선택)
npx github: 방식은 매 실행마다 GitHub에서 받아 빌드합니다. 더 빠른 시작을 원하면 npm에 게시하세요:
npm publish --access public게시 후에는 모든 config에서 github:jeonghwanko/coffee-price-mcp 를 coffee-price-mcp 로 바꾸면 됩니다.
라이선스
MIT · 데이터 출처: coffee.pryzm.gg 공개 혜택 API