What can you do with this server?

This MCP server provides AI assistants with natural language access to Korea's Public Procurement Service (G2B/조달청) and Nuri Jangteo (private procurement) OpenAPI, covering 14 services and 156 operations across the entire public procurement lifecycle. Core Public Procurement Services * Bid Announcements — Search construction, services, goods, and foreign procurement notices, including change history and participation regions * Pre-specifications — Query pre-release specifications (사전규격) by category and institution * Bid Results — Access successful bid records, bid opening results, failed bids, and re-bids * Contract Information — Retrieve contract details, change history, and deletion history * Contract Process Disclosure — View the integrated full contract lifecycle * Order Plans — Explore planned procurements by goods, services, construction, or foreign categories * Price Information — Look up facility material prices, market construction prices, and standard unit prices (civil, architectural, mechanical, electrical) * Public Procurement Statistics — Analyze by institution, enterprise, contract method, region, and product/service * Data Standards — Retrieve bid, award, and contract data in open standard format * Industry & Legal Basis — Look up industry classifications and related laws * User Information — Query institution info, procurement company profiles, industry registrations, and debarred companies Private Procurement (누리장터) Services * Private Bid Announcements, Bid Results, and Contracts — Full coverage of private-sector procurement data Discovery & Utility Tools * list_g2b_services — Browse all 14 services and their operations * get_g2b_operation_info — Get detailed specs (parameters, response fields, example URLs) for any operation * get_g2b_cache_data — Filter, paginate, search by substring, apply regex, or semantically re-rank cached API results Key Features: automatic full pagination, results cached to JSON to protect LLM context, retry with exponential backoff, optional semantic re-ranking with Korean sentence embeddings, and support for both stdio and HTTP transports.

How do I use mcp-kr-g2b?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-kr-g2b 2024년 1월에 올라온 공사 입찰공고를 찾아줘" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-kr-g2b

by ChangooLee

Overview Schema Source Related Servers Discussions Admin

Python

Remote

This MCP server provides AI assistants with natural language access to Korea's Public Procurement Service (G2B/조달청) and Nuri Jangteo (private procurement) OpenAPI, covering 14 services and 156 operations across the entire public procurement lifecycle.

Core Public Procurement Services

Bid Announcements — Search construction, services, goods, and foreign procurement notices, including change history and participation regions
Pre-specifications — Query pre-release specifications (사전규격) by category and institution
Bid Results — Access successful bid records, bid opening results, failed bids, and re-bids
Contract Information — Retrieve contract details, change history, and deletion history
Contract Process Disclosure — View the integrated full contract lifecycle
Order Plans — Explore planned procurements by goods, services, construction, or foreign categories
Price Information — Look up facility material prices, market construction prices, and standard unit prices (civil, architectural, mechanical, electrical)
Public Procurement Statistics — Analyze by institution, enterprise, contract method, region, and product/service
Data Standards — Retrieve bid, award, and contract data in open standard format
Industry & Legal Basis — Look up industry classifications and related laws
User Information — Query institution info, procurement company profiles, industry registrations, and debarred companies

Private Procurement (누리장터) Services

Private Bid Announcements, Bid Results, and Contracts — Full coverage of private-sector procurement data

Discovery & Utility Tools

list_g2b_services — Browse all 14 services and their operations
get_g2b_operation_info — Get detailed specs (parameters, response fields, example URLs) for any operation
get_g2b_cache_data — Filter, paginate, search by substring, apply regex, or semantically re-rank cached API results

Key Features: automatic full pagination, results cached to JSON to protect LLM context, retry with exponential backoff, optional semantic re-ranking with Korean sentence embeddings, and support for both stdio and HTTP transports.

한국어 | English

MCP 조달청 나라장터 (KR-G2B)

조달청 나라장터(국가종합전자조달, G2B) 및 누리장터(민간조달) OpenAPI를 위한 Model Context Protocol(MCP) 서버입니다. 공공데이터포털(data.go.kr)을 통해 제공되는 조달청 14개 서비스, 156개 오퍼레이션을 AI 어시스턴트가 자연어로 조회·분석할 수 있게 합니다.

입찰공고·사전규격·낙찰·계약·발주계획·가격정보·공공조달통계까지, 공공조달 전 과정의 데이터를 하나의 MCP로 연결합니다.

사용 예시

AI 어시스턴트에게 다음과 같은 요청을 할 수 있습니다:

📢 입찰공고 검색 — "2024년 1월에 올라온 공사 입찰공고를 찾아줘"
🏆 낙찰 분석 — "특정 수요기관의 최근 물품 낙찰 현황을 정리해줘"
📄 계약 조회 — "지난달 체결된 용역 계약 내역을 보여줘"
💰 가격정보 — "시설자재(토목) 가격정보를 조회해줘"
📊 조달통계 — "기관 구분별 공공조달 실적 통계를 알려줘"
🏗️ 사전규격 — "발주 예정인 사전규격(사전공개) 목록을 확인해줘"

Related MCP server: narajangteo-pro

지원 서비스

조달청 OpenAPI 14개 서비스를 모두 포함합니다. 각 서비스는 get_<module>_data 도구 하나로 호출하며, operation 파라미터로 세부 오퍼레이션을 지정합니다.

구분	서비스	도구	오퍼레이션
나라장터	입찰공고정보서비스	`get_bid_data`	25
	사전규격정보서비스	`get_prestd_data`	20
	낙찰정보서비스	`get_scsbid_data`	23
	계약정보서비스	`get_contract_data`	21
	계약과정 통합공개서비스	`get_contract_process_data`	4
	발주계획 현황서비스	`get_order_plan_data`	8
	가격정보 현황서비스	`get_price_data`	11
	공공데이터 개방표준서비스	`get_data_standard_data`	3
	업종 및 근거법규서비스	`get_industry_data`	1
	사용자정보서비스	`get_user_info_data`	5
공공조달	공공조달통계정보서비스	`get_stats_data`	14
누리장터	민간입찰공고서비스	`get_nuri_bid_data`	10
	민간낙찰정보서비스	`get_nuri_scsbid_data`	7
	민간계약정보서비스	`get_nuri_contract_data`	4

디스커버리·캐시 도구

도구	설명
`list_g2b_services`	14개 서비스와 오퍼레이션 개요 목록 (탐색 시작점)
`get_g2b_operation_info`	특정 오퍼레이션의 요청 파라미터·필수여부·응답 필드·예제 URL
`get_g2b_cache_data`	캐시 결과를 필드 필터/제외/정규식/의미 기반 재정렬/페이지로 상세 조회

총 17개 MCP 도구 = 서비스 디스패처 14개 + 디스커버리/캐시 3개. 오퍼레이션이 156개로 많아, "서비스당 도구 1개 + operation 파라미터" 방식으로 설계해 도구 수를 안정적으로 유지합니다.

권장 사용 흐름

1. list_g2b_services()                         → 어떤 서비스/오퍼레이션이 있는지 파악
2. get_g2b_operation_info("bid", "getBidPblancListInfoCnstwk")
                                               → 정확한 파라미터(필수/선택) 확인
3. get_bid_data(operation="getBidPblancListInfoCnstwk",
                params={"inqryDiv": "1",
                        "inqryBgnDt": "202401010000",
                        "inqryEndDt": "202401312359"})
                                               → 전체 페이지 수집 + 캐시 저장 + 요약 반환
4. get_g2b_cache_data(cache_file="...",        → 캐시에서 상세/필터 조회
                      field_name="dminsttNm",
                      field_value_substring="서울")

대량 결과는 LLM 컨텍스트를 보호하기 위해 요약 + 미리보기 5건 + 캐시 파일 경로만 반환하며, 전체 데이터는 캐시 파일에 저장되어 get_g2b_cache_data 로 탐색합니다.

키워드 정밀도 보정 & 의미 기반 리랭커

조달청 검색 API의 공고명(bidNtceNm) 필터는 단순 부분일치라 노이즈가 섞입니다 — 예: 재활 → 재활용(폐기물), 투자 → 투자유치/투자설명회. get_g2b_cache_data 가 이를 보정합니다.

# 1) 어휘 필터 (의존성 없음, 기본 제공)
get_g2b_cache_data(cache_file, field_name="bidNtceNm",
                   exclude_substrings=["재활용","직업재활시설"])      # 노이즈 제거
get_g2b_cache_data(cache_file, field_value_regex="재활(?!용)")        # 정밀 매칭

# 2) 의미 기반 재정렬 (선택 설치: pip install "mcp-kr-g2b[ml]")
get_g2b_cache_data(cache_file,
                   rerank_query="디지털 헬스케어 AI 근골격계 재활 동작분석")
#  → 회사/사업 설명문과의 유사도(ko-sroberta 임베딩)로 적합도 순 정렬 + _relevance 점수

리랭커는 sentence-transformers(torch 포함)가 필요해 기본 설치에서 제외했습니다. 미설치 시 rerank_query 호출은 설치 안내를 반환하고, 그 외 기능은 정상 동작합니다. 모델은 G2B_RERANK_MODEL(기본 jhgan/ko-sroberta-multitask)로 변경할 수 있습니다.

빠른 시작 가이드

1. 인증 설정 (서비스키 발급)

조달청 OpenAPI는 공공데이터포털을 통해 제공됩니다.

공공데이터포털 회원가입
사용할 조달청 서비스(예: "나라장터 입찰공고정보서비스")를 검색하여 활용신청
마이페이지 → 오픈API → 인증키에서 일반 인증키(Encoding) 확인
부동산(mcp-kr-realestate) 서버와 동일한 키를 공유할 수 있습니다.

참고: 서비스마다 활용신청 승인이 필요합니다. 승인되지 않은 서비스 호출 시 20 서비스 접근 거부 에러가 반환됩니다.

2. 설치

# 저장소 복제
git clone https://github.com/ChangooLee/mcp-kr-g2b.git
cd mcp-kr-g2b

# Python 3.10 이상 필수
python3 -m venv .venv
source .venv/bin/activate

# 패키지 설치
python3 -m pip install --upgrade pip
pip install -e .

# (선택) 의미 기반 리랭커까지 설치하려면 — torch 포함, 용량 큼
pip install -e ".[ml]"

3. 환경변수 설정

.env.example 을 복사하여 .env 를 만들고 서비스키를 입력합니다.

cp .env.example .env
# .env 편집: PUBLIC_DATA_API_KEY_ENCODED=발급받은_Encoding_키

IDE 통합

Claude Desktop 설정

햄버거 메뉴(☰) > Settings > Developer > "Edit Config" 에서 추가:

{
  "mcpServers": {
    "mcp-kr-g2b": {
      "command": "YOUR_LOCATION/.venv/bin/mcp-kr-g2b",
      "env": {
        "PUBLIC_DATA_API_KEY_ENCODED": "발급받은_Encoding_서비스키",
        "TRANSPORT": "stdio",
        "LOG_LEVEL": "INFO",
        "MCP_SERVER_NAME": "mcp-kr-g2b"
      }
    }
  }
}

Streamable HTTP (선택)

{
  "mcpServers": {
    "mcp-kr-g2b": {
      "command": "YOUR_LOCATION/.venv/bin/mcp-kr-g2b",
      "env": {
        "PUBLIC_DATA_API_KEY_ENCODED": "발급받은_Encoding_서비스키",
        "HOST": "0.0.0.0",
        "PORT": "8002",
        "TRANSPORT": "streamable-http",
        "LOG_LEVEL": "INFO",
        "MCP_SERVER_NAME": "mcp-kr-g2b"
      }
    }
  }
}

NOTE

YOUR_LOCATION: 가상환경이 설치된 실제 경로로 변경
TRANSPORT="streamable-http" 설정 시 엔드포인트는 http://HOST:PORT/mcp

주요 환경 변수

변수	설명	기본값
`PUBLIC_DATA_API_KEY_ENCODED`	공공데이터포털 서비스키(Encoding). `G2B_SERVICE_KEY` 로도 지정 가능	(필수)
`G2B_NUM_OF_ROWS`	페이지당 결과 수(최대 999)	500
`G2B_MAX_PAGES`	전체 조회 시 최대 페이지 수	50
`G2B_REQUEST_TIMEOUT`	요청 타임아웃(초)	60
`G2B_MAX_RETRIES`	일시적 오류(타임아웃/5xx/4xx) 재시도 횟수	3
`G2B_RETRY_BACKOFF`	재시도 지수 백오프 기준(초)	0.6
`G2B_TLS_VERIFY`	https 호스트 사용 시 TLS 인증서 검증	true
`MCP_G2B_CACHE_DIR`	캐시 디렉토리	패키지 내부(`utils/_cache_store/raw_data`)
`G2B_RERANK_MODEL`	(선택) 리랭커 임베딩 모델	jhgan/ko-sroberta-multitask
`G2B_RERANK_MAX_CANDIDATES`	(선택) 리랭크 평가 후보 상한	2000
`HOST` / `PORT`	서버 호스트/포트	0.0.0.0 / 8002
`TRANSPORT`	`stdio` / `streamable-http` / `sse`	stdio
`LOG_LEVEL`	로깅 레벨	INFO

잘못된 값(예: 숫자 환경변수에 문자)이 들어와도 서버가 죽지 않고 경고 후 기본값으로 폴백합니다.

Docker로 실행하기

# 이미지 빌드
docker build -t mcp-kr-g2b:latest .

# .env 파일 사용(권장)
docker run -d \
  --name mcp-kr-g2b \
  -p 8002:8002 \
  --env-file .env \
  -e TRANSPORT=streamable-http \
  mcp-kr-g2b:latest

# 또는 환경변수 직접 전달
docker run -d \
  --name mcp-kr-g2b \
  -p 8002:8002 \
  -e PUBLIC_DATA_API_KEY_ENCODED=your-encoded-key \
  -e TRANSPORT=streamable-http \
  mcp-kr-g2b:latest

아키텍처

mcp-opendart 의 모듈 구조와 mcp-kr-realestate 의 공공데이터포털 호출/캐싱 전략을 결합했습니다.

src/mcp_kr_g2b/
├── server.py              # FastMCP 엔트리, G2BContext(전역 컨텍스트), 도구 등록
├── config.py              # G2BConfig / MCPConfig (환경변수)
├── apis/
│   ├── client.py          # 공공데이터포털 클라이언트(curl 우선 + requests 폴백,
│   │                      #   serviceKey 처리, JSON/XML 자동판별, 페이지네이션)
│   └── service.py         # G2BService: 번들 명세 기반 제네릭 서비스 호출
├── tools/
│   ├── <module>_tools.py  # 서비스별 get_<module>_data 도구 (14개, 코드 생성)
│   ├── common_tools.py    # list_g2b_services / get_g2b_operation_info / get_g2b_cache_data
│   └── _helpers.py        # 디스패치·요약·설명 생성 공통 로직
├── specs/                 # 조달청 OpenAPI 명세(JSON, 원본 .docx 파싱 결과)
└── utils/
    ├── cache.py           # 조회 결과 캐싱(raw → JSON 파일, 원자적 기록) + 요약
    ├── reranker.py        # (선택) 의미 기반 리랭커 — sentence-transformers 지연 임포트
    └── ctx_helper.py      # 컨텍스트 폴백, as_json_text

호출·캐싱 흐름

graph TD
    A["get_&lt;module&gt;_data(operation, params)"] --> B[G2BService.fetch]
    B --> C[G2BClient.fetch_all<br/>numOfRows/pageNo 페이지네이션]
    C --> D{JSON or XML?}
    D --> E[items / totalCount 정규화]
    E --> F[전체 결과 → 캐시 JSON 저장]
    F --> G[요약 + 미리보기 5건 + cache_file 반환]
    G --> H["get_g2b_cache_data 로 상세/필터 조회"]

문제 해결 및 디버깅

조달청 OpenAPI는 공통 에러코드를 사용합니다:

코드	의미	조치
`00`	정상	-
`03` / `07`	데이터 없음 / 입력범위 초과	조회조건(기간 등) 확인 (빈 결과로 처리)
`10`~`12`	잘못된 요청 / 필수 파라미터 누락	`get_g2b_operation_info` 로 필수 파라미터 확인
`20`	서비스 접근 거부	해당 서비스 활용신청 승인 여부 확인
`22`	요청 제한 초과	일일 트래픽 한도 확인
`30`/`31`	등록되지 않은/만료된 서비스키	키 값 및 인코딩(Encoding 키 사용) 확인

# 상세 로깅
export LOG_LEVEL=DEBUG

인증키 인코딩: 본 서버는 어떤 키(Encoding/Decoding)를 넣어도 정규 인코딩 형식으로 변환해 사용하며, 서비스별로 동작하는 키 형식을 자동 탐지·캐시합니다. %2B, %2F, %3D 등이 포함된 Encoding 키를 그대로 넣는 것을 권장합니다.

신뢰성 & 품질

공용 배포를 위해 다음을 보강했습니다(라이브 156개 오퍼레이션 전수 검증 기반).

재시도 + 지수 백오프: 게이트웨이의 일시적 5xx/타임아웃/4xx 를 자동 재시도. 4xx 본문을 데이터로 오인하지 않도록 curl --fail 적용.
키 형식 자동 페일오버: Encoding/Decoding 차이를 흡수하고, 정상 응답 본문의 우연한 문자열에 오탐하지 않도록 resultCode 우선 판정.
정확한 페이지네이션: totalCount 미제공 시에도 "가득 찬 페이지" 기준으로 끝까지 수집(1페이지 조용한 종료 방지). 상한(max_pages) 도달 시 truncated/missingCount 로 절단을 명시.
캐시 견고성: 호출 변형(전체조회 vs 페이지)을 키에 반영해 덮어쓰기 충돌 방지, cachedAt(신선도) 기록, 임시파일+os.replace 원자적 기록, 동시성 락.
명확한 에러: HTML 점검페이지/깨진 응답을 graceful 처리하고, 비-bid 캐시에 없는 필드로 필터하면 무음 0건 대신 FIELD_NOT_FOUND 를 반환.
테스트: pytest 40종(명세 무결성·클라이언트 파싱·캐시·도구). 네트워크 없이 실행됩니다.

pip install -e ".[dev]"
pytest -q

보안

서비스키를 절대 공유하지 마세요.
.env 파일을 안전하게 보관하고 저장소에 커밋하지 마세요(.gitignore 적용됨).
API 사용량(일일 트래픽)을 모니터링하세요.

라이선스

이 프로젝트는 비상업적, 개인, 연구/학습, 비영리 목적에 한해 사용할 수 있습니다(CC BY-NC 4.0). 상업적 사용은 금지됩니다. 자세한 내용은 LICENSE를 참고하세요.

이 프로젝트는 공식 조달청 제품이 아닙니다. 데이터의 정확성·최신성은 공공데이터포털 및 조달청 원본을 기준으로 합니다.

Available Tools

17 tools

get_bid_dataA

[나라장터 입찰공고정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('bid', '') 로 확인하세요.

사용 가능한 오퍼레이션 (25개):

getBidPblancListInfoCnstwk: 입찰공고목록 정보에 대한 공사조회
getBidPblancListInfoServc: 입찰공고목록 정보에 대한 용역조회
getBidPblancListInfoFrgcpt: 입찰공고목록 정보에 대한 외자조회
getBidPblancListInfoThng: 입찰공고목록 정보에 대한 물품조회
getBidPblancListInfoThngBsisAmount: 입찰공고목록 정보에 대한 물품기초금액조회
getBidPblancListInfoCnstwkBsisAmount: 입찰공고목록 정보에 대한 공사기초금액조회
getBidPblancListInfoServcBsisAmount: 입찰공고목록 정보에 대한 용역기초금액조회
getBidPblancListInfoChgHstryThng: 입찰공고목록 정보에 대한 물품변경이력조회
getBidPblancListInfoChgHstryCnstwk: 입찰공고목록 정보에 대한 공사변경이력조회
getBidPblancListInfoChgHstryServc: 입찰공고목록 정보에 대한 용역변경이력조회
getBidPblancListInfoCnstwkPPSSrch: 나라장터검색조건에 의한 입찰공고공사조회
getBidPblancListInfoServcPPSSrch: 나라장터검색조건에 의한 입찰공고용역조회
getBidPblancListInfoFrgcptPPSSrch: 나라장터검색조건에 의한 입찰공고외자조회
getBidPblancListInfoThngPPSSrch: 나라장터검색조건에 의한 입찰공고물품조회
getBidPblancListInfoLicenseLimit: 입찰공고목록 정보에 대한 면허제한정보조회
getBidPblancListInfoPrtcptPsblRgn: 입찰공고목록 정보에 대한 참가가능지역정보조회
getBidPblancListInfoThngPurchsObjPrdct: 입찰공고목록 정보에 대한 물품 구매대상물품조회
getBidPblancListInfoServcPurchsObjPrdct: 입찰공고목록 정보에 대한 용역 구매대상물품조회
getBidPblancListInfoFrgcptPurchsObjPrdct: 입찰공고목록 정보에 대한 외자 구매대상물품조회
getBidPblancListInfoEorderAtchFileInfo: 입찰공고목록 정보에 대한 e발주 첨부파일정보조회
getBidPblancListInfoEtc: 입찰공고목록 정보에 대한 기타공고조회
getBidPblancListInfoEtcPPSSrch: 나라장터검색조건에 의한 입찰공고 기타조회
getBidPblancListPPIFnlRfpIssAtchFileInfo: 입찰공고목록 정보에 대한 혁신장터 최종제안요청서 교부 첨부파일정보조회
getBidPblancListBidPrceCalclAInfo: 입찰공고목록 정보에 대한 입찰가격산식A정보조회
getBidPblancListEvaluationIndstrytyMfrcInfo: 입찰공고목록 정보에 대한 평가대상주력분야 조회

자주 쓰는 조회조건: inqryDiv(조회구분 코드, 보통 1=등록/공고일시), inqryBgnDt/inqryEndDt(YYYYMMDDHHMM 조회기간), bidNtceNo(입찰공고번호), dminsttNm(수요기관명), indstrytyNm(업종명), prdctClsfcNo(품목분류번호) 등. ⚠️ 날짜 기반 조회(inqryBgnDt/inqryEndDt 등)는 보통 한 번에 1개월 이내 범위만 허용됩니다. 기간이 길면 월 단위로 나눠 호출하세요. 'PPSSrch' 오퍼레이션은 bidNtceNm(공고명 일부)/indstrytyNm/추정가격 범위 등 상세 검색조건을 지원합니다.

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_contract_dataA

[나라장터 계약정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('contract', '') 로 확인하세요.

사용 가능한 오퍼레이션 (21개):

getCntrctInfoListThng: 계약현황에 대한 물품조회
getCntrctInfoListThngDetail: 계약현황에 대한 물품세부조회
getCntrctInfoListThngPPSSrch: 나라장터검색조건에 의한 계약현황 물품조회
getCntrctInfoListThngChgHstry: 계약현황에 대한 물품변경이력조회
getCntrctInfoListThngDltHstry: 계약현황에 대한 물품삭제이력조회
getCntrctInfoListCnstwk: 계약현황에 대한 공사조회
getCntrctInfoListCnstwkServcInfo: 계약현황에 대한 공사서비스정보조회
getCntrctInfoListCnstwkPPSSrch: 나라장터검색조건에 의한 계약현황 공사조회
getCntrctInfoListCnstwkChgHstry: 계약현황에 대한 공사변경이력조회
getCntrctInfoListCnstwkDltHstry: 계약현황에 대한 공사삭제이력조회
getCntrctInfoListServc: 계약현황에 대한 용역조회
getCntrctInfoListGnrlServcServcInfo: 계약현황에 대한 일반용역서비스정보조회
getCntrctInfoListTechServcServcInfo: 계약현황에 대한 기술용역서비스정보조회
getCntrctInfoListServcPPSSrch: 나라장터검색조건에 의한 계약현황 용역조회
getCntrctInfoListServcChgHstry: 계약현황에 대한 용역변경이력조회
getCntrctInfoListServcDltHstry: 계약현황에 대한 용역삭제이력조회
getCntrctInfoListFrgcpt: 계약현황에 대한 외자조회
getCntrctInfoListFrgcptDetail: 계약현황에 대한 외자세부조회
getCntrctInfoListFrgcptPPSSrch: 나라장터검색조건에 의한 계약현황 외자조회
getCntrctInfoListFrgcptChgHstry: 계약현황에 대한 외자변경이력조회
getCntrctInfoListFrgcptDltHstry: 계약현황에 대한 외자삭제이력조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_contract_process_dataA

[나라장터 계약과정통합공개서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('contract_process', '') 로 확인하세요.

사용 가능한 오퍼레이션 (4개):

getCntrctProcssIntgOpenFrgcpt: 계약과정통합공개정보에 대한 외자조회
getCntrctProcssIntgOpenThng: 계약과정통합공개정보에 대한 물품조회
getCntrctProcssIntgOpenServc: 계약과정통합공개정보에 대한 용역조회
getCntrctProcssIntgOpenCnstwk: 계약과정통합공개정보에 대한 공사조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_data_standard_dataA

[나라장터 공공데이터개방표준서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('data_standard', '') 로 확인하세요.

사용 가능한 오퍼레이션 (3개):

getDataSetOpnStdBidPblancInfo: 데이터셋 개방표준에 따른 입찰공고정보
getDataSetOpnStdScsbidInfo: 데이터셋 개방표준에 따른 낙찰정보
getDataSetOpnStdCntrctInfo: 데이터셋 개방표준에 따른 계약정보

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_g2b_cache_dataA

get__data 호출로 저장된 캐시 파일(cache_file)에서 전체 결과를 필드 필터/페이지 단위로 조회합니다. 대량 조회 결과를 미리보기 이후 상세 탐색할 때 사용합니다.

Inputs: cache_file (required), field_name, field_value_substring, offset, +1 more.

get_g2b_operation_infoA

특정 서비스 오퍼레이션의 상세 명세(요청 파라미터·필수여부·응답 필드·예제 URL)를 조회합니다. get__data 를 호출하기 전에 params 에 넣을 정확한 파라미터명을 확인할 때 사용하세요. operation 을 생략하면 해당 서비스의 전체 오퍼레이션 목록을 반환합니다.

Inputs: module (required), operation.

get_industry_dataA

[나라장터 업종 및 근거법규서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('industry', '') 로 확인하세요.

사용 가능한 오퍼레이션 (1개):

getIndstrytyBaseLawrgltInfoList: 업종 및 근거법규 정보 조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_nuri_bid_dataA

[누리장터 민간입찰공고서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('nuri_bid', '') 로 확인하세요.

사용 가능한 오퍼레이션 (10개):

getPrvtBidPblancListInfoServc: 민간입찰공고정보에 대한 용역조회
getPrvtBidPblancListInfoThng: 민간입찰공고정보에 대한 물품조회
getPrvtBidPblancListInfoCnstwk: 민간입찰공고정보에 대한 공사조회
getPrvtBidPblancListInfoEtc: 민간입찰공고정보에 대한 기타조회
getPrvtBidPblancListInfoLicenseLimit: 민간입찰공고정보에 대한 면허제한정보조회
getPrvtBidPblancListInfoPrtcptPsblRgn: 민간입찰공고정보에 대한 참가가능지역정보조회
getPrvtBidPblancListInfoServcPPSSrch: 나라장터 검색조건에 의한 민간입찰공고정보에 대한 용역조회
getPrvtBidPblancListInfoThngPPSSrch: 나라장터 검색조건에 의한 민간입찰공고정보에 대한 물품조회
getPrvtBidPblancListInfoCnstwkPPSSrch: 나라장터 검색조건에 의한 민간입찰공고정보에 대한 공사조회
getPrvtBidPblancListInfoEtcPPSSrch: 나라장터 검색조건에 의한 민간입찰공고정보에 대한 기타조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_nuri_contract_dataA

[누리장터 민간계약정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('nuri_contract', '') 로 확인하세요.

사용 가능한 오퍼레이션 (4개):

getPrvtCntrctInfoList: 계약현황 민간조회
getPrvtCntrctInfoListPPSSrch: 나라장터 검색조건에 의한 계약현황 민간조회
getPrvtCntrctInfoListChgHstry: 계약현황에 대한 민간변경이력조회
getPrvtCntrctInfoListDltHstry: 계약현황에 대한 민간삭제이력조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_nuri_scsbid_dataA

[누리장터 민간낙찰정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('nuri_scsbid', '') 로 확인하세요.

사용 가능한 오퍼레이션 (7개):

getPrvtScsbidListSttus: 민간 낙찰된 목록 현황 조회
getPrvtOpengResultListInfo: 민간 개찰결과 목록 조회
getPrvtScsbidListSttusPPSSrch: 나라장터 검색조건에 의한 민간 낙찰된 목록 현황 조회
getPrvtOpengResultListInfoPPSSrch: 나라장터 검색조건에 의한 민간 개찰결과 목록 조회
getPrvtOpengResultListInfoOpengCompt: 민간 개찰결과 개찰완료 목록 조회
getPrvtOpengResultListInfoFailing: 민간 개찰결과 유찰 목록 조회
getPrvtOpengResultListInfoRebid: 민간 개찰결과 재입찰 목록 조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_order_plan_dataA

[나라장터 발주계획현황서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('order_plan', '') 로 확인하세요.

사용 가능한 오퍼레이션 (8개):

getOrderPlanSttusListThng: 발주계획현황에 대한 물품조회
getOrderPlanSttusListCnstwk: 발주계획현황에 대한 공사조회
getOrderPlanSttusListServc: 발주계획현황에 대한 용역조회
getOrderPlanSttusListFrgcpt: 발주계획현황에 대한 외자조회
getOrderPlanSttusListThngPPSSrch: 나라장터 검색조건에 의한 발주계획현황에 대한 물품조회
getOrderPlanSttusListCnstwkPPSSrch: 나라장터 검색조건에 의한 발주계획현황에 대한 공사조회
getOrderPlanSttusListServcPPSSrch: 나라장터 검색조건에 의한 발주계획현황에 대한 용역조회
getOrderPlanSttusListFrgcptPPSSrch: 나라장터 검색조건에 의한 발주계획현황에 대한 외자조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_prestd_dataA

[나라장터 사전규격정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('prestd', '') 로 확인하세요.

사용 가능한 오퍼레이션 (20개):

getPublicPrcureThngInfoThng: 사전규격 물품 목록 조회
getInsttAcctoThngListInfoThng: 사전규격 물품 기관별 목록 조회
getThngDetailMetaInfoThng: 사전규격 물품 품목별 목록 조회
getPublicPrcureThngInfoFrgcpt: 사전규격 외자 목록 조회
getInsttAcctoThngListInfoFrgcpt: 사전규격 외자 기관별 목록 조회
getThngDetailMetaInfoFrgcpt: 사전규격 외자 품목별 목록 조회
getPublicPrcureThngInfoServc: 사전규격 용역 목록 조회
getInsttAcctoThngListInfoServc: 사전규격 용역 기관별 목록 조회
getThngDetailMetaInfoServc: 사전규격 용역 품목별 목록 조회
getPublicPrcureThngInfoCnstwk: 사전규격 공사 목록 조회
getInsttAcctoThngListInfoCnstwk: 사전규격 공사 기관별 목록 조회
getThngDetailMetaInfoCnstwk: 사전규격 공사 품목별 목록 조회
getPublicPrcureThngInfoThngPPSSrch: 나라장터 검색조건에 의한 사전규격 물품 목록 조회
getPublicPrcureThngInfoFrgcptPPSSrch: 나라장터 검색조건에 의한 사전규격 외자 목록 조회
getPublicPrcureThngInfoServcPPSSrch: 나라장터 검색조건에 의한 사전규격 용역 목록 조회
getPublicPrcureThngInfoCnstwkPPSSrch: 나라장터 검색조건에 의한 사전규격 공사 목록 조회
getPublicPrcureThngOpinionInfoThng: 나라장터 사전규격 물품 규격서 의견 목록 조회
getPublicPrcureThngOpinionInfoFrgcpt: 나라장터 사전규격 외자 규격서 의견 목록 조회
getPublicPrcureThngOpinionInfoServc: 나라장터 사전규격 용역 규격서 의견 목록 조회
getPublicPrcureThngOpinionInfoCnstwk: 나라장터 사전규격 공사 규격서 의견 목록 조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_price_dataA

[나라장터 가격정보현황서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('price', '') 로 확인하세요.

사용 가능한 오퍼레이션 (11개):

getPriceInfoListFcltyCmmnMtrilEngrk: 시설공통자재(토목) 가격정보
getPriceInfoListFcltyCmmnMtrilBildng: 시설공통자재(건축) 가격정보
getPriceInfoListFcltyCmmnMtrilMchnEqp: 시설공통자재(기계설비) 가격정보
getPriceInfoListFcltyCmmnMtrilElctyIrmc: 시설공통자재(전기, 정보통신) 가격정보
getPriceInfoListMrktCnstrctPcEngrk: 시장시공가격(토목) 가격정보
getPriceInfoListMrktCnstrctPcBildng: 시장시공가격(건축) 가격정보
getPriceInfoListMrktCnstrctPcMchnEqp: 시장시공가격(기계설비) 가격정보
getCnsttyClsfcInfoList: 공종분류및세부공종
getStdMarkUprcinfoList: 표준시장단가및시장시공가격 정보
getNetRsceinfoList: 자원분류및순수자원
getPriceInfoListFcltyCmmnMtrilTotal: 시설공통자재(종합) 가격정보

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_scsbid_dataA

[나라장터 낙찰정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('scsbid', '') 로 확인하세요.

사용 가능한 오퍼레이션 (23개):

getScsbidListSttusThng: 낙찰된 목록 현황 물품조회
getScsbidListSttusCnstwk: 낙찰된 목록 현황 공사조회
getScsbidListSttusServc: 낙찰된 목록 현황 용역조회
getScsbidListSttusFrgcpt: 낙찰된 목록 현황 외자조회
getOpengResultListInfoThng: 개찰결과 물품 목록 조회
getOpengResultListInfoCnstwk: 개찰결과 공사 목록 조회
getOpengResultListInfoServc: 개찰결과 용역 목록 조회
getOpengResultListInfoFrgcpt: 개찰결과 외자 목록 조회
getOpengResultListInfoThngPreparPcDetail: 개찰결과 물품 예비가격상세 목록 조회
getOpengResultListInfoCnstwkPreparPcDetail: 개찰결과 공사 예비가격상세 목록 조회
getOpengResultListInfoServcPreparPcDetail: 개찰결과 용역 예비가격상세 목록 조회
getOpengResultListInfoFrgcptPreparPcDetail: 개찰결과 외자 예비가격상세 목록 조회
getOpengResultListInfoOpengCompt: 개찰결과 개찰완료 목록 조회
getOpengResultListInfoFailing: 개찰결과 유찰 목록 조회
getOpengResultListInfoRebid: 개찰결과 재입찰 목록 조회
getScsbidListSttusThngPPSSrch: 나라장터 검색조건에 의한 낙찰된 목록 현황 물품조회
getScsbidListSttusCnstwkPPSSrch: 나라장터 검색조건에 의한 낙찰된 목록 현황 공사조회
getScsbidListSttusServcPPSSrch: 나라장터 검색조건에 의한 낙찰된 목록 현황 용역조회
getScsbidListSttusFrgcptPPSSrch: 나라장터 검색조건에 의한 낙찰된 목록 현황 외자조회
getOpengResultListInfoThngPPSSrch: 나라장터 검색조건에 의한 개찰결과 물품 목록 조회
getOpengResultListInfoCnstwkPPSSrch: 나라장터 검색조건에 의한 개찰결과 공사 목록 조회
getOpengResultListInfoServcPPSSrch: 나라장터 검색조건에 의한 개찰결과 용역 목록 조회
getOpengResultListInfoFrgcptPPSSrch: 나라장터 검색조건에 의한 개찰결과 외자 목록 조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_stats_dataA

[공공조달통계정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('stats', '') 로 확인하세요.

사용 가능한 오퍼레이션 (14개):

getTotlPubPrcrmntSttus: 전체 공공조달 현황
getInsttDivAccotPrcrmntSttus: 기관구분별 조달 현황
getEntrprsDivAccotPrcrmntSttus: 기업구분별 조달 현황
getCntrctMthdAccotSttus: 계약방법별 현황
getRgnLmtSttus: 지역제한 현황
getRgnDutyCmmnCntrctSttus: 지역의무공동계약 현황
getPrcrmntObjectBsnsObjAccotSttus: 조달목적물(업무대상)별 현황
getDminsttAccotEntrprsDivAccotArslt: 수요기관별 기업구분별 실적
getDminsttAccotCntrctMthdAccotArslt: 수요기관별 계약방법별 실적
getDminsttAccotBsnsObjAccotArslt: 수요기관별 업무대상별 실적
getDminsttAccotSystmTyAccotArslt: 수요기관별 시스템유형별 실적
getPrcrmntEntrprsAccotCntrctMthdAccotArslt: 조달기업별 계약방법별 실적
getPrcrmntEntrprsAccotBsnsObjAccotArslt: 조달기업별 업무대상별 실적
getPrdctIdntNoServcAccotArslt: 품목 및 서비스별 실적

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

get_user_info_dataA

[나라장터 사용자정보서비스] 조달청 나라장터 OpenAPI 조회 도구. operation 에 아래 오퍼레이션명(영문) 중 하나를 지정하고, params 에 해당 오퍼레이션의 조회조건을 dict 로 전달하세요. numOfRows/pageNo/type/serviceKey 는 자동 처리됩니다. 각 오퍼레이션의 정확한 파라미터/응답필드는 get_g2b_operation_info('user_info', '') 로 확인하세요.

사용 가능한 오퍼레이션 (5개):

getDminsttInfo02: 수요기관정보조회
getPrcrmntCorpBasicInfo02: 조달업체 기본정보
getPrcrmntCorpIndstrytyInfo02: 조달업체업종정보조회
getPrcrmntCorpSplyPrdctInfo02: 조달업체공급물품정보조회
getUnptRsttCorpInfo02: 부정당재제업체정보조회

Inputs: operation (required), params, fetch_all, num_of_rows, +1 more.

list_g2b_servicesA

조달청 나라장터/누리장터 MCP가 제공하는 14개 서비스와 각 서비스의 오퍼레이션 개요를 조회합니다. 어떤 서비스/오퍼레이션을 호출할지 결정하기 위한 출발점입니다. 각 서비스는 get__data 도구로 호출하며, 상세 파라미터는 get_g2b_operation_info 로 확인합니다.

Inputs: include_operations.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.4/5.0

Scored 2026-06-20 08:31 across 17 tools

Disambiguation5/5

Each tool targets a distinct module (bid, contract, statistics, user info, etc.) with no overlap. The support tools (get_g2b_operation_info, get_g2b_cache_data, list_g2b_services) have clearly separate purposes. An agent can easily differentiate them.

Naming Consistency5/5

All data retrieval tools follow the pattern get_<module>_data. Support tools use get_g2b_* and list_g2b_services, maintaining a consistent prefix. No mixed conventions or ambiguity.

Tool Count5/5

17 tools cover a comprehensive set of procurement data domains (bids, contracts, plans, prices, statistics, user info, etc.) without being excessive. Each tool serves a necessary function, well-scoped for the server's purpose.

Completeness5/5

The tool surface covers all major procurement lifecycle stages (pre-bid, bid, award, contract, statistics, user info) across public and private sectors. Support tools for metadata and caching fill gaps. No obvious missing operations for a read-only data API.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

alphago2580-naramarketmcp
ai.smithery
Access Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…
Government Data Open Data E-commerce & Retail
25
https://server.smithery.ai/@alphago2580/naramarketmcp/mcp
ComePass — Korean Companies & Public ProcurementA
xyz.comepass.agents
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Finance Government Data
41
https://agents.comepass.xyz/mcp
나라장터 입찰 MCPA
io.github.donghyeon01
나라장터 입찰공고·사전규격·낙찰정보 검색. Korean public procurement bids via KONEPS open API.
Government Data Open Data
51
https://kr-public-mcp.songdonghyeon01.workers.dev/mcp
Korea TendersA
io.github.pipeworx-io
Korea Government Procurement MCP — KONEPS (나라장터 / g2b) open bids and procurement vendors, via BOIM…
Government Data Open Data
491
https://gateway.pipeworx.io/korea-tenders/mcp

Related MCP Servers

Nara Market FastMCP Server
Government Data Search E-commerce & Retail
alphago2580
A
license
Not graded
quality
D
maintenance
Provides access to South Korean government procurement (G2B) and Nara Market shopping mall data, enabling users to search bid announcements, procurement statistics, product catalogs, and contract information through 15 specialized tools.
Updated 9 months ago (2026-02-09 04:36 UTC)
5
Apache 2.0
narajangteo-pro
Government Data Search
kyj2294
A
license
A
quality
D
maintenance
Integrates 6 Korean public procurement APIs to search, analyze, and manage procurement data using natural language.
Updated 7 months ago (2026-04-26 07:58 UTC)
8
3
MIT
G2B Bid MCP Server
Government Data Search Open Data
jjmcpa93-design
F
license
Not graded
quality
D
maintenance
Enables searching and retrieving bid notices from the Korean Public Procurement Service (G2B) through Claude.
Updated 4 months ago (2026-07-27 06:14 UTC)
-
kr-public-mcp
Government Data Open Data Search
donghyeon01
A
license
Not graded
quality
C
maintenance
Enables AI assistants such as Claude, ChatGPT, and Cursor to search Korean public procurement bid announcements, view detailed bid information, access pre-specifications, and analyze award history from 나라장터 (Public Procurement Service), with source links and no installation or API key required for basic use.
Updated 21 days ago (2026-10-22 16:22 UTC)
MIT

MCP 조달청 나라장터 (KR-G2B)

사용 예시

지원 서비스

디스커버리·캐시 도구

권장 사용 흐름

키워드 정밀도 보정 & 의미 기반 리랭커

빠른 시작 가이드

1. 인증 설정 (서비스키 발급)

2. 설치

3. 환경변수 설정

IDE 통합

Claude Desktop 설정

Streamable HTTP (선택)

주요 환경 변수

Docker로 실행하기

아키텍처

호출·캐싱 흐름

문제 해결 및 디버깅

신뢰성 & 품질

보안

라이선스

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Nara Market FastMCP Server

narajangteo-pro

G2B Bid MCP Server

kr-public-mcp