loading…
Search for a command to run...
loading…
Integrates 6 Korean public procurement APIs to search, analyze, and manage procurement data using natural language.
Integrates 6 Korean public procurement APIs to search, analyze, and manage procurement data using natural language.
나라장터 공공조달 API 6종을 통합한 MCP 서버입니다. Claude Desktop 등 MCP 클라이언트와 연결해 자연어로 입찰공고 검색, 시장 분석, 입찰 적합도 평가 등을 수행할 수 있습니다.
나라장터 주요 공공 API를 통합해 다양한 데이터를 조회할 수 있도록 구성했습니다.
공통 API 클라이언트(api/client.py)에서 다음 기능을 처리합니다.
LLM 환경에서 효율적으로 활용할 수 있도록 기능 단위 도구로 구성했습니다.
| 도구명 | 설명 |
|---|---|
search_procurement |
입찰 / 낙찰 / 계약 / 요청 / 쇼핑몰 통합 검색 |
get_procurement_detail |
상세 정보 조회 |
trace_procurement_lifecycle |
조달 진행 단계 추적 |
analyze_market |
키워드 기반 시장 동향 분석 |
analyze_competitor |
특정 기업 조달 활동 분석 |
score_bid_fit |
기업 정보 기반 입찰 적합도 분석 |
manage_watchlist |
관심 키워드 등록 및 신규 공고 확인 |
manage_company_profile |
회사 프로필 저장 / 불러오기 |
사용자가 일상적인 표현으로 입력해도 API 파라미터로 자동 변환되도록 구현했습니다.
기간 표현 — 최근 7일 / 지난 3개월 / 올해
금액 표현 — 5억 / 1.5억 / 3천만원
업무구분 동의어 — 서비스 → 용역 / 건설 → 공사
SQLite 기반으로 사용자 설정 데이터를 저장합니다. 저장 항목은 Watchlist와 회사 프로필이며, 기본 저장 위치는 아래와 같습니다.
~/.narajangteo-pro/state.db
공공데이터포털에서 아래 서비스를 활용신청한 후, 마이페이지 → 개발계정에서 ServiceKey의 Decoding 값을 복사합니다.
# uvx (권장 — Python 설치 없이 실행)
uvx narajangteo-pro
# npx
npx narajangteo-pro
# pip
pip install narajangteo-pro
narajangteo-pro
아래 경로의 설정 파일을 수정합니다.
~/Library/Application Support/Claude/claude_desktop_config.json%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
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"narajangteo-pro": {
"command": "npx",
"args": []
}
}
}