narajangteo-pro
The narajangteo-pro server integrates 6 Korean public procurement (나라장터) APIs, enabling natural language-driven search, market analysis, competitor research, and bid evaluation through 8 MCP tools.
search_procurement— Unified search across 5 domains (bid announcements, award results, contracts, procurement requests, shopping mall items) with keyword, institution, period, and business type filtering. Supports natural language date/amount expressions.get_procurement_detail— Retrieve full details for a specific bid notice, award result, contract, procurement request, or shopping item using its ID.trace_procurement_lifecycle— Track an entire procurement process from pre-specification → announcement → award → contract in a single call using one identifier.analyze_market— Keyword-based market analysis covering monthly trends, average award rates, top institutions/companies, and estimated market size.analyze_competitor— Analyze a specific company's procurement activity: award counts/amounts, key business areas, average award rates, and client patterns.score_bid_fit— Score bid suitability (0–100) by matching a company's licenses, certifications, revenue, and prior contracts against bid requirements. Accepts saved or inline profiles.manage_watchlist— Monitor procurement opportunities by adding/removing keywords, listing watched terms, and checking for new bid notices since the last check.manage_company_profile— Save, load, list, or delete company profiles (licenses, certifications, revenue, contracts) for reuse in bid fit evaluations, with natural language revenue input (e.g., '50억').
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@narajangteo-proSearch for recent IT procurement notices"
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.
naramarket-pro-MCP
나라장터 공공조달 API 6종을 통합한 MCP 서버입니다. Claude Desktop 등 MCP 클라이언트와 연결해 자연어로 입찰공고 검색, 시장 분석, 입찰 적합도 평가 등을 수행할 수 있습니다.
주요 기능
공공조달 API 6종 연동
나라장터 주요 공공 API를 통합해 다양한 데이터를 조회할 수 있도록 구성했습니다.
입찰공고: 키워드, 기관, 기간 기준 공고 검색
낙찰정보: 낙찰 업체 및 금액 조회
계약정보: 실제 계약 체결 내역 확인
계약과정통합공개: 사전규격부터 계약까지 전체 진행 과정 추적
조달요청: 발주 이전 단계 데이터 조회
종합쇼핑몰 품목: 단가계약 등록 품목 검색
공통 API 클라이언트(api/client.py)에서 다음 기능을 처리합니다.
응답 형식 정규화
요청 타임아웃 시 자동 재시도 (최대 2회)
메모리 캐시 (기본 5분)
MCP 도구 8종 구성
LLM 환경에서 효율적으로 활용할 수 있도록 기능 단위 도구로 구성했습니다.
도구명 | 설명 |
| 입찰 / 낙찰 / 계약 / 요청 / 쇼핑몰 통합 검색 |
| 상세 정보 조회 |
| 조달 진행 단계 추적 |
| 키워드 기반 시장 동향 분석 |
| 특정 기업 조달 활동 분석 |
| 기업 정보 기반 입찰 적합도 분석 |
| 관심 키워드 등록 및 신규 공고 확인 |
| 회사 프로필 저장 / 불러오기 |
자연어 입력 처리
사용자가 일상적인 표현으로 입력해도 API 파라미터로 자동 변환되도록 구현했습니다.
기간 표현 — 최근 7일 / 지난 3개월 / 올해
금액 표현 — 5억 / 1.5억 / 3천만원
업무구분 동의어 — 서비스 → 용역 / 건설 → 공사
상태 저장
SQLite 기반으로 사용자 설정 데이터를 저장합니다. 저장 항목은 Watchlist와 회사 프로필이며, 기본 저장 위치는 아래와 같습니다.
~/.narajangteo-pro/state.db빠른 시작
1. API 키 발급
공공데이터포털에서 아래 서비스를 활용신청한 후, 마이페이지 → 개발계정에서 ServiceKey의 Decoding 값을 복사합니다.
조달청_나라장터 입찰공고정보서비스
조달청_나라장터 낙찰정보서비스
조달청_나라장터 계약정보서비스
조달청_나라장터 계약과정통합공개서비스
2. 설치
# uvx (권장 — Python 설치 없이 실행)
uvx narajangteo-pro
# npx
npx narajangteo-pro
# pip
pip install narajangteo-pro
narajangteo-pro3. Claude Desktop 연결
아래 경로의 설정 파일을 수정합니다.
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"narajangteo-pro": {
"command": "uvx",
"args": ["narajangteo-pro@latest"],
"env": {
"NARA_API_KEY": "발급받은_디코딩_서비스키"
}
}
}
}Claude Desktop을 재시작하면 바로 사용할 수 있습니다.
"최근 1개월 AI 챗봇 분야 시장 분석해줘"
"공고번호 20260415123 사전규격부터 계약까지 전체 진행상황 보여줘"
"우리 회사 프로필로 이 공고 입찰해도 될지 평가해줘"
아키텍처
┌─────────────────────────────────────┐
│ Claude Desktop / Cursor / VS Code │
└──────────────────┬──────────────────┘
│ MCP (stdio | HTTP)
┌──────────────────▼──────────────────┐
│ narajangteo-pro │
│ ┌────────┐ ┌──────────┐ ┌──────┐ │
│ │ Tools │→ │Analytics │→ │ DB │ │
│ └───┬────┘ └────┬─────┘ └──────┘ │
│ └────────────┘ │
│ ┌──────────┐ │
│ │API Client│ │
│ └────┬─────┘ │
└──────────────┼──────────────────────┘
│
┌─────────▼──────────┐
│ 공공데이터포털 │
│ 나라장터 API 6종 │
└────────────────────┘라이선스
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/kyj2294/naramarket-pro-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server