나라장터 입찰공고 MCP 서버

조달청 나라장터 입찰공고정보서비스(공공데이터포털)를 Claude에서 사용할 수 있게 해주는 MCP 서버입니다.

제공 도구

• search_bid_notices: 물품/공사/용역/외자 입찰공고를 기간, 공고명 키워드, 기관명, 지역제한으로 검색
• call_raw_operation: 기초금액, 면허제한 등 그 외 오퍼레이션을 직접 호출

배포 방법 (Vercel, 무료)

1단계. GitHub에 올리기

1. https://github.com/new 에서 새 저장소를 만듭니다 (예: g2b-bid-mcp, Private 가능)
2. 이 폴더 전체를 업로드합니다
   • 웹에서: 저장소 페이지 → "uploading an existing file" 클릭 → 폴더 내 파일 전부 드래그
   • 또는 터미널에서:

     cd g2b-bid-mcp
     git init && git add . && git commit -m "init"
     git remote add origin https://github.com/내아이디/g2b-bid-mcp.git
     git push -u origin main
     

2단계. Vercel에 배포

1. https://vercel.com 접속 → GitHub 계정으로 로그인
2. Add New → Project → 방금 만든 저장소 Import
3. Environment Variables 섹션에서 환경변수 추가:
   • Name: G2B_API_KEY
   • Value: 공공데이터포털에서 받은 일반 인증키(Decoding) 붙여넣기
4. Deploy 클릭 → 1~2분 후 완료
5. 배포 완료 화면에서 도메인 확인 (예: https://g2b-bid-mcp.vercel.app)

인증키를 나중에 추가/수정했다면 Settings → Environment Variables에서 저장 후 Deployments 탭에서 Redeploy 해야 적용됩니다.

3단계. Claude에 커스텀 커넥터 등록

1. claude.ai → 설정(Settings) → 커넥터(Connectors)
2. 커스텀 커넥터 추가 (Add custom connector) 클릭
3. 입력:
   • 이름: 나라장터 입찰공고 (자유)
   • URL: https://내도메인.vercel.app/api/mcp ← 끝에 /api/mcp 필수
4. 추가 후, 새 채팅에서 입력창의 도구(연장 아이콘) 메뉴에서 커넥터를 켭니다

4단계. 사용 예시

• "이번 주 세종 지역 공사 입찰공고 찾아줘"
• "공고명에 '소프트웨어' 들어간 용역 입찰 최근 한 달치 조회해줘"

주의사항

• 인증키는 절대 코드에 직접 넣지 말고 환경변수로만 관리하세요
• 개발계정은 일일 트래픽 제한이 있습니다 (활용사례 등록 시 운영계정으로 증설 가능)
• 인증키 오류(SERVICE_KEY_IS_NOT_REGISTERED)가 나면 Encoding 키가 아닌 Decoding 키를 넣었는지 확인하세요