Skip to main content
Glama
narajangteo-pro

narajangteo-pro

by kyj2294

naramarket-pro-MCP

这是一个集成了 6 种韩国国家综合电子采购网 (Nara Market) 公共采购 API 的 MCP 服务器。通过与 Claude Desktop 等 MCP 客户端连接,可以使用自然语言进行招标公告搜索、市场分析、投标适宜性评估等操作。


主要功能

6 种公共采购 API 联动

整合了国家综合电子采购网的主要公共 API,支持查询多种数据。

  • 招标公告: 按关键词、机构、日期搜索公告

  • 中标信息: 查询中标企业及金额

  • 合同信息: 确认实际合同签署明细

  • 合同流程综合公开: 追踪从预先规格到合同签署的全过程

  • 采购请求: 查询发标前阶段的数据

  • 综合购物中心品目: 搜索单价合同注册品目

通用 API 客户端 (api/client.py) 处理以下功能:

  • 响应格式标准化

  • 请求超时自动重试(最多 2 次)

  • 内存缓存(默认 5 分钟)


8 种 MCP 工具配置

为了在 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

Related MCP server: narajangteo-searcher

快速开始

1. 获取 API 密钥

在 公共数据门户 (data.go.kr) 申请使用以下服务后,在“我的页面” → “开发账号”中复制 ServiceKey 的 Decoding 值。

  • 韩国采购厅_国家综合电子采购网招标公告信息服务

  • 韩国采购厅_国家综合电子采购网中标信息服务

  • 韩国采购厅_国家综合电子采购网合同信息服务

  • 韩国采购厅_国家综合电子采购网合同流程综合公开服务

2. 安装

# uvx (권장 — Python 설치 없이 실행)
uvx narajangteo-pro

# npx
npx narajangteo-pro

# pip
pip install narajangteo-pro
narajangteo-pro

3. 连接 Claude Desktop

修改以下路径的配置文件。

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %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

Available Tools

8 tools
analyze_competitorA

특정 기업의 조달시장 활동 분석.

낙찰 건수/금액, 주력 분야, 평균 낙찰가율, 거래 발주기관 패턴을 분석.

Args: company_name: 기업명 (정확하지 않아도 부분 일치) period_months: 분석 기간 business_type: 업무구분 또는 'all'

Inputs: company_name (required), period_months, business_type. Returns: object

analyze_marketA

특정 분야 시장 동향 분석.

낙찰 데이터를 집계하여 월별 추이, 평균 낙찰가율, 상위 발주기관/낙찰업체, 추정 시장 규모를 반환.

Args: keyword: 분석 대상 키워드 (예: 'AI 챗봇', '클라우드') period_months: 분석 기간 — 기본 12개월 business_type: 업무구분 또는 'all' (4개 합산)

Inputs: keyword (required), period_months, business_type. Returns: object

get_procurement_detailA

입찰공고/낙찰/계약/조달요청/쇼핑몰품목 상세 정보 조회.

Args: domain: 'bid'(입찰공고), 'award'(낙찰), 'contract'(계약), 'request'(조달요청), 'shopping'(종합쇼핑몰 품목) notice_no: 식별 번호 - bid/award: 입찰공고번호 - contract: 확정계약번호 - request: 조달요청번호 - shopping: 품목식별번호 business_type: 업무구분 (shopping은 무시) notice_ord: 공고차수 (보통 '00')

Inputs: domain (required), notice_no (required), business_type, notice_ord. Returns: object

manage_company_profileA

회사 프로필 관리 — 적합도 평가에 재사용.

actions: - 'save': 저장 (profile_id, name 필수). 같은 ID면 업데이트. - 'load': 조회 (profile_id 필수) - 'list': 모든 프로필 목록 - 'delete': 삭제 (profile_id 필수)

revenue는 자연어 표현 가능: '50억', '100억원' 등.

Inputs: action (required), profile_id, name, licenses, +4 more. Returns: object

manage_watchlistB

관심 키워드 모니터링.

actions: - 'add': 새 키워드 등록 (keyword 필수) - 'remove': 등록 해제 (watch_id 필수) - 'list': 등록된 키워드 목록 - 'check_new': 등록한 키워드의 신규 공고 (마지막 확인 이후)

Inputs: action (required), keyword, business_type, institution, +1 more. Returns: object

score_bid_fitA

입찰 적합도 평가 — 0-100 점수 + 권고.

회사 프로필(보유 면허, 매출, 실적)과 공고 요구사항을 매칭해 적합도를 산출.

Args: bid_notice_no: 입찰공고번호 business_type: 업무구분 profile_id: 저장된 회사 프로필 ID (manage_company_profile로 미리 저장) inline_profile: 즉석 프로필 dict (저장 없이 일회성 평가) {"licenses": [...], "certifications": [...], "revenue": int, "prior_contracts": [...]} notice_ord: 공고차수

Inputs: bid_notice_no (required), business_type, profile_id, inline_profile, +1 more. Returns: object

search_procurementA

나라장터 통합 검색 도구.

하나의 도구로 5개 영역을 모두 검색한다.

Args: domain: 검색 영역 - 'bid': 입찰공고 - 'award': 낙찰결과 - 'contract': 체결된 계약 - 'request': 조달요청 (발주의 가장 이른 단계 — 영업 선행지표) - 'shopping': 종합쇼핑몰 품목 (단가계약 등록 품목) business_type: 업무구분 — '물품', '용역', '공사', '외자' (자연어 표현 자동 매핑) 'shopping' 도메인은 이 파라미터를 무시. keyword: 공고명/품목명 키워드 institution: 발주기관/계약기관명 (shopping에선 공급업체명으로 사용) period: 자연어 기간 — '최근 7일', '지난 3개월', '올해' 등 (date_from/to보다 우선) date_from: 시작일 YYYYMMDD date_to: 종료일 YYYYMMDD limit: 최대 결과 수 (1-100)

Returns: {"items": [...], "total_count": int, "page_no": int}

Inputs: domain, business_type, keyword, institution, +4 more. Returns: object

trace_procurement_lifecycleA

⭐ 조달 전 과정 추적 — 사전규격 → 공고 → 낙찰 → 계약을 한 번에.

이 도구가 narajangteo-pro의 시그니처 기능. 식별자 하나만 알면 조달 라이프사이클 전체를 추적해 타임라인으로 반환한다.

Args: id_value: 식별 번호 business_type: 업무구분 id_type: 식별자 종류 - 'bid_notice': 입찰공고번호 (가장 흔함) - 'spec': 사전규격등록번호 - 'plan': 발주계획번호 - 'request': 조달요청번호

Inputs: id_value (required), business_type, id_type. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: analysis per company or market, detail retrieval, profile/watchlist management, fit scoring, search, and lifecycle tracing. No two tools overlap significantly.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, e.g., analyze_competitor, manage_watchlist. No mixing of camelCase or other conventions.

    Tool Count5/5

    8 tools is ideal for this domain, covering search, detail, analysis, management, scoring, and tracing without being too few or too many.

    Completeness4/5

    Covers core procurement activities well, but lacks a direct tool for comparing bids or exporting reports. The analysis tools provide aggregated data, mitigating minor gaps.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to query and analyze Korean public procurement data from the Korea Public Procurement Service (G2B/Nuri) via 14 services and 156 operations, including bid announcements, contracts, prices, and statistics.
      17
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables users to search and analyze Korean public procurement IT bid announcements, including full bid opening results, through natural language conversation with Claude.
      8
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching Korean procurement notices from the public data portal, with support for integrated search across categories, flexible date ranges, and attachment extraction.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables querying Korean procurement corporate profiles and qualifications using business registration numbers through natural language, leveraging the public data API from data.go.kr.
      2
      52 npm
      MIT