# 세금장터 MCP (TESTLAB)

**세금장터(TESTLAB)** 의 공공 비교시험 데이터를 MCP 도구로 노출하는 원격 MCP 서버입니다.
한국소비자원·소비자24의 **공공 비교시험(비교공감)** 결과 — 어떤 제품이 정부 주관 시험에서
가장 좋은 평가를 받았는지, 항목별 등급, 공식 리콜·위해정보 — 를 에이전트가 조회할 수 있게 합니다.

- 공개 웹서비스: https://ko-gov-item.vercel.app (도메인 이전 예정: 세금장터.kr)
- 프로토콜: MCP over **Streamable HTTP** (stateless), 경로 `/mcp/`
- 스택: Python 3.12 · [FastMCP](https://github.com/jlowin/fastmcp)

## 원칙

- **공공근거만**: 모든 순위·등급은 한국소비자원 비교공감 / 소비자24 공공 비교시험에서 검증된
  데이터만 제공합니다. 실제 시험 근거가 없는 "유형 예시(pending)" 행은 아예 번들에서 제외됩니다.
- **광고 없음**: 이 MCP는 투명성 도구입니다. **쿠팡 파트너스 등 어떤 상업/제휴 링크도 포함하지
  않습니다** (데이터 추출 단계에서 상업 필드를 전부 제거).
- **출처 명시**: 모든 도구 응답에 공식 출처(기관명·URL·시험기관·시점)를 함께 반환합니다.

## 도구 (7개, 모두 read-only)

| 도구 | 설명 |
|---|---|
| `list_test_categories` | 분야·품목 커버리지 개요(품목별 비교 개수, 1위) |
| `search_tested_products` | 키워드로 공공 시험 품목/제품 검색 |
| `rank_products_in_category` | 한 품목의 공공 비교시험 순위(상태·근거·출처) |
| `get_comparison_report` | 품목의 비교공감 상세 리포트(평가항목·등급 매트릭스·추천픽·발견·주석) |
| `get_product_test_detail` | 특정 제품 한 개의 시험 결과 상세(하이라이트·안전성·리콜·출처) |
| `get_public_source_records` | 품목 데이터의 공식 출처 목록(인용·검증용) |
| `find_product_recalls` | 리콜·위해정보(한국소비자원·CISS) 조회 |

## 데이터

공개 비교시험 데이터의 스냅샷을 패키지에 **번들**합니다(`src/taxmarket_mcp/_data/catalog.json`).
런타임에 외부 네트워크를 쓰지 않으므로 오프라인 환경(카카오 클라우드 egress 차단)에서도 동작하며,
개인정보는 포함되지 않습니다.

데이터 갱신(원본 세금장터 레포에서 재추출):

```bash
# ko-gov-item 레포에서
EXPORT_MCP=1 MCP_OUT=/path/out npx vitest run scripts/export-mcp-catalog.test.ts
# 산출된 catalog.json을 이 레포의 src/taxmarket_mcp/_data/ 로 복사
```

## 개발

```bash
pip install -e ".[dev]"
pytest            # 유닛 테스트
ruff check .      # 린트
python -m taxmarket_mcp   # 서버 기동 (http://0.0.0.0:8080/mcp/)
```

## 라이선스

MIT. 데이터 출처: 한국소비자원·소비자24 공공 비교시험(비교공감).