Skip to main content
Glama
man2service

taxfood-mcp

by man2service
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

세금맛집 MCP 서버 (taxfood-mcp)

전국 공공기관이 **업무추진비(세금)**로 식사한 식당 데이터를 AI 에이전트가 쓸 수 있는 MCP(Model Context Protocol) 도구로 노출하는 서버입니다. 카카오 PlayMCP / AGENTIC PLAYER 10 출품용. 모든 근거에 공식 정보공개 출처 링크가 붙는 투명성·정보공개 서비스입니다.

데이터 원본/지도 서비스: https://taxfood.kr

설계 원칙

  • Streamable HTTP, 스테이트리스 원격 MCP 서버 (PlayMCP 요구사항). 단일 POST /mcp/.

  • 데이터 무동봉: 데이터셋은 런타임에 공개 CDN(https://taxfood.kr/data/*.json)에서 fetch + 인메모리 캐시. → 이 공개 레포에는 데이터·개인정보·시크릿이 일절 포함되지 않습니다.

  • 응답 단계 PII 스크럽: 혹시 모를 이름+직함 패턴을 응답에서 제거.

  • 모든 출력에 카카오맵 딥링크(map.kakao.com/link/...) 동봉.

Related MCP server: fiscal-api-mcp

도구 (7)

도구

기능

search_tax_restaurants

이름/지역/구 검색 + 정렬

find_nearby_tax_restaurants

좌표 기반 주변 검색(카톡 위치공유)

rank_tax_restaurants_in_area

시/도·구 지출 랭킹

get_agency_dining_summary

기관별 지출 집계

get_place_spending_detail

근거 원장(날짜·부서·금액·목적)

get_spend_source_records

공식 출처 링크만 반환(검증)

list_regions_overview

지역 커버리지/총계

로컬 실행

pip install -e ".[dev]"
python -m taxmatjip_mcp          # http://0.0.0.0:8080/mcp/

# 검증
pytest
npx @modelcontextprotocol/inspector   # tools/list, tools/call 스모크

배포 (카카오 클라우드 / PlayMCP in KC)

playmcp.kakaocloud.io → + 새 MCP 서버 등록 → Git 소스 빌드 → 이 레포 URL + Dockerfile → Endpoint URL 발급 → PlayMCP 콘솔에 <endpoint>/mcp/ 등록.

환경변수: PORT(기본 8080), TAXMATJIP_DATA_BASE_URL(기본 https://taxfood.kr/data).

라이선스

MIT (코드). 데이터는 각 공공기관 정보공개 자료가 원본이며 본 레포에 포함되지 않습니다.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers