Quokka Korea Tools

Claude·Cursor 같은 AI 에이전트가 한국 날짜·금액·번호를 추측하지 않고 계산하게 하는 원격 MCP 서버입니다.

2026년부터 노동절(5월 1일)과 제헌절(7월 17일)이 공휴일이 됐습니다. 그 전에 학습한 모델은 이걸 모를 수 있고, 나중에 정해지는 대체공휴일·선거일도 모릅니다. 이 서버는 한국천문연구원 특일 자료와 정해진 규칙으로 답합니다.

https://mcp.thequokkacompany.com/korea

가입 없이 주소 하나만 넣으면 됩니다. 무료 사용에는 키가 필요 없습니다.

연결

Claude Code

claude mcp add --transport http korea-tools https://mcp.thequokkacompany.com/korea

Cursor·Windsurf·VS Code 등(mcp.json)

{
  "mcpServers": {
    "korea-tools": { "type": "http", "url": "https://mcp.thequokkacompany.com/korea" }
  }
}

Claude.ai·Claude 데스크톱: 설정 → 커넥터 → 커스텀 커넥터 추가에 위 주소를 넣습니다.

도구 15개

`kr_holidays`	연도나 기간의 공휴일 목록(대체공휴일·선거일 포함)
`kr_business_day`	그날이 영업일인지, 앞뒤 영업일
`kr_add_business_days`	시작일에서 영업일 N일 뒤(음수면 앞)
`kr_count_business_days`	두 날짜 사이 영업일 수
`kr_amount_to_korean`	숫자를 한글 금액으로: 백이십삼만 원, 일금 일백이십삼만원정, 123만 원
`kr_korean_to_amount`	1억 2천만 원, 삼백오십만원, 2.5억을 정확한 숫자로
`kr_business_number_check`	사업자등록번호 검증번호 확인과 123-45-67890 모양 맞추기(휴·폐업 조회는 아님)
`kr_age`	생년월일이나 주민번호 앞 7자리로 만 나이·연 나이
`kr_phone_format`	전화번호 한 모양으로(+82, 엑셀이 지운 0, 내선)
`kr_address_split`	주소를 시도·시군구·도로명·상세주소로
`kr_name_split`	성과 이름 나누기(남궁·황보 같은 두 글자 성)
`kr_mask_pii`	글 속 주민번호·전화·이메일·카드번호 가리기
`kr_legal_deadline`	민법 기간 계산: 초일 불산입, 월·연은 달력대로, 말일이 토·공휴일이면 다음 날
`kr_text_count`	글자 수(공백 포함·제외), 나이스 바이트, 문자 SMS·LMS 바이트
`kr_relative_date`	내일모레·글피·다음 주 화요일·3영업일 후를 날짜와 요일로

HTTP API

MCP를 못 쓰는 곳에서는 같은 도구를 일반 API로 부릅니다. POST https://mcp.thequokkacompany.com/api/korea/<도구 이름>에 인자를 JSON으로 보냅니다. 명세: /openapi.json, 에이전트용 설명: /llms.txt.

curl -s https://mcp.thequokkacompany.com/api/korea/kr_add_business_days \
  -H 'content-type: application/json' -d '{"start":"2026-09-23","days":3}'

9월 23일에서 영업일 3일 뒤는 추석 연휴(9/24~26)와 일요일을 건너뛴 9월 30일입니다.

사용 한도

무료: 클라이언트 하나당 하루 200회. 한국 시간 0시에 다시 셉니다.
한도를 늘리는 유료 키는 준비 중입니다. 판매 전까지는 무료만 있습니다.

하지 않는 것

공휴일 자료는 2024~2027년입니다(한국천문연구원 특일 자료, 2026-11-12 갱신). 그 뒤에 정해진 임시공휴일은 저희가 넣기 전까지 빠져 있습니다. 범위 밖 연도는 추측하지 않고 오류를 돌려줍니다.
사업자등록번호는 검증번호 규칙만 봅니다. 국세청에 휴·폐업 여부를 묻지 않습니다.
주소 나누기는 규칙으로 합니다. 도로명주소 데이터베이스를 조회하지 않습니다.

개인정보

도구에 넣은 값은 저장하거나 로그에 남기지 않습니다. 하루 한도를 세려고 IP 주소와 User-Agent를 비밀 값으로 해시한 문자열, 도구 이름, 날짜별 횟수만 둡니다.

더쿼카스튜디오 · contact@thequokkacompany.com