nara-bid-mcp

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

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

핵심 장점

• 공식 공공데이터포털 조달 API 사용

• 물품/용역/공사/외자 통합 검색

• start_date/end_date 고정 기간 검색과 days_back 최근기간 검색 모두 지원

• 긴 기간은 10일 단위 자동 청킹

• 검색어·수요기관 로컬 후처리 필터와 relevance score 제공

• 사전규격 검색 선택 지원

• RFP/제안요청서/과업지시서 첨부파일 자동 식별

• 응답 크기 보호: 큰 원문은 핵심 필드 중심으로 압축

• ServiceKey 로그/오류 마스킹

• 첨부파일 텍스트 추출 시 허용 호스트만 다운로드

Related MCP server: Nara Market FastMCP Server

환경변수

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

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

실행

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 등록 예시

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