# nara-bid-mcp

나라장터 입찰공고 검색용 MCP 서버입니다. 기존 로컬 프로젝트들의 장점만 모았습니다.

문서 파싱은 `kordoc`을 1차 파서로 사용합니다. 자세한 출처 표기는 [`NOTICE.md`](NOTICE.md)를 참고하세요.

## 핵심 장점

- 공식 공공데이터포털 조달 API 사용
- 물품/용역/공사/외자 통합 검색
- `start_date`/`end_date` 고정 기간 검색과 `days_back` 최근기간 검색 모두 지원
- 긴 기간은 10일 단위 자동 청킹
- 검색어·수요기관 로컬 후처리 필터와 relevance score 제공
- 사전규격 검색 선택 지원
- RFP/제안요청서/과업지시서 첨부파일 자동 식별
- 응답 크기 보호: 큰 원문은 핵심 필드 중심으로 압축
- ServiceKey 로그/오류 마스킹
- 첨부파일 텍스트 추출 시 허용 호스트만 다운로드

## 환경변수

`.env` 파일 또는 실행 환경에 아래 중 하나를 설정합니다.

```env
NARA_SERVICE_KEY=공공데이터포털_서비스키
# 호환용
NARAMARKET_SERVICE_KEY=공공데이터포털_서비스키
```

## 실행

```bash
uv sync --extra dev
uv run nara-bid-mcp
```

## MCP 도구

- `server_info`: 서버 상태와 기능 목록
- `search_procurement_notices`: 입찰공고 + 선택적 사전규격 검색
- `get_notice_attachments`: 특정 공고 첨부/RFP URL 추출
- `extract_attachment_text`: 허용된 G2B/data.go.kr 첨부 URL 텍스트 추출
- `get_search_strategy`: 실무 검색 절차 가이드

## Hermes 등록 예시

```yaml
mcp:
  servers:
    nara-bid:
      command: uv
      args: ["--directory", "/home/user/mydev/nara-bid-mcp", "run", "nara-bid-mcp"]
      env:
        NARA_SERVICE_KEY: "..."
        UV_LINK_MODE: copy
```