# kr-public-mcp — 나라장터 입찰공고 MCP 서버

[![MCP](https://img.shields.io/badge/MCP-Streamable%20HTTP-7c3aed)](https://modelcontextprotocol.io/)
[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-F38020?logo=cloudflare&logoColor=white)](https://workers.cloudflare.com/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

Claude·ChatGPT·Cursor에서 나라장터(조달청) 입찰공고를 검색하고 상세를 조회하는 원격 MCP 서버.
설치·인증키 없이 URL만 붙이면 동작한다 (Streamable HTTP).

- 엔드포인트: `https://kr-public-mcp.songdonghyeon01.workers.dev/mcp`
- 데이터: 조달청 나라장터 공공데이터포털 오픈API (입찰공고·사전규격·낙찰정보)
- 모든 응답에 출처와 나라장터 원문 링크를 포함한다

## 도구

| 도구               | 등급 | 설명                                                                             |
| ------------------ | ---- | -------------------------------------------------------------------------------- |
| `search_bids`      | 무료 | 입찰공고 검색 — 키워드·기간·업무구분(공사/용역/물품/외자)·지역·추정가 범위       |
| `get_bid_detail`   | 무료 | 공고 상세 — 자격요건(면허·참가지역), 일정, 기초금액·추정가, 첨부 링크, 변경 이력 |
| `search_pre_specs` | Pro  | 사전규격 검색 — 본공고 전 단계 조기 발굴                                         |
| `analyze_history`  | Pro  | 낙찰 이력 집계 — 낙찰률 분포·다빈도 업체·평균 참가수                             |
| `watch_bids`       | Pro  | 알림 조건 저장 → 매일 08:00 KST 이메일 매칭 + 마감 임박 알림                     |

무료 도구는 IP 기준 일 30회. Pro는 라이선스 키(크몽 이용권)로 한도 해제 + Pro 도구 개방.

## 연결

```bash
# Claude Code
claude mcp add --transport http narajangteo https://kr-public-mcp.songdonghyeon01.workers.dev/mcp
```

```jsonc
// 일반 MCP 클라이언트 설정
{
  "mcpServers": {
    "narajangteo": {
      "url": "https://kr-public-mcp.songdonghyeon01.workers.dev/mcp",
    },
  },
}
```

Pro 키 사용 시 헤더: `Authorization: Bearer <라이선스 키>`.

## 사용 예시

```text
사용자: 이번 주 마감하는 서울 지역 용역 입찰공고 찾아줘
→ search_bids(keyword="", region="서울", category="용역", deadline="...") 호출
→ 공고명·마감일·추정가·나라장터 원문 링크 목록 응답

사용자: 0012345678 공고의 참가자격 알려줘
→ get_bid_detail(bidNo="0012345678") 호출
→ 면허·지역 제한, 입찰 일정, 기초금액, 첨부 링크 응답
```

## 아키텍처

Cloudflare Workers (stateless `createMcpHandler`) + D1 + KV + Cron.
수집(Cron → 조달청 API → D1)과 조회(MCP → D1)를 분리해 API 호출 수를 사용자 수와 무관하게 유지 (서버비 ≈ 0 설계).
공무원 성명·연락처는 응답에서 제거하고 저장하지 않는다.

## 개발

```bash
npm install
npm run db:migrate:local && npm run dev
npm run typecheck
```

셋업·배포·운영 규칙: `AGENTS.md` 참조.

## 라이선스

MIT. 데이터 출처: 조달청 나라장터 (공공데이터포털 오픈API).