naramarket-pro-MCP

This is an MCP server that integrates 6 types of KONEPS (Korea ON-line E-Procurement System) public procurement APIs. You can connect it to MCP clients like Claude Desktop to perform tasks such as searching for bid notices, analyzing the market, and evaluating bid suitability using natural language.

Key Features

Integration of 6 Public Procurement APIs

We have integrated major KONEPS public APIs to allow for the retrieval of various data.

• Bid Notices: Search for notices by keyword, organization, and period.

• Bid Results: Retrieve information on winning bidders and amounts.

• Contract Information: Verify actual contract execution details.

• Integrated Contract Process Disclosure: Track the entire process from pre-specifications to contracts.

• Procurement Requests: Retrieve data from the pre-ordering stage.

• Comprehensive Shopping Mall Items: Search for items registered under unit price contracts.

The common API client (api/client.py) handles the following functions:

• Normalization of response formats

• Automatic retries on request timeouts (up to 2 times)

• Memory caching (default 5 minutes)

8 MCP Tools

Configured as functional tools for efficient use in LLM environments.

Natural Language Processing

Implemented to automatically convert user input in everyday language into API parameters.

Period Expressions — last 7 days / past 3 months / this year

Amount Expressions — 500 million / 150 million / 30 million won

Work Category Synonyms — service → service / construction → construction work

State Storage

Stores user configuration data based on SQLite. Saved items include Watchlist and company profiles; the default storage location is as follows.

~/.narajangteo-pro/state.db

Related MCP server: mcp-kr-g2b

Quick Start

1. API Key Issuance

After applying for the services below at the Public Data Portal, copy the Decoding value of the ServiceKey from My Page → Development Account.

• Public Procurement Service_KONEPS Bid Notice Information Service

• Public Procurement Service_KONEPS Bid Result Information Service

• Public Procurement Service_KONEPS Contract Information Service

• Public Procurement Service_KONEPS Integrated Contract Process Disclosure Service

2. Installation

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

# npx
npx narajangteo-pro

# pip
pip install narajangteo-pro
narajangteo-pro

3. Connect to Claude Desktop

Modify the configuration file at the following path:

• 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": "발급받은_디코딩_서비스키"
      }
    }
  }
}

You can use it immediately after restarting Claude Desktop.

"Analyze the market for AI chatbots over the last month"

"Show me the entire progress from pre-specification to contract for notice number 20260415123"

"Evaluate whether we should bid on this notice based on our company profile"

Architecture

┌─────────────────────────────────────┐
│  Claude Desktop / Cursor / VS Code  │
└──────────────────┬──────────────────┘
                   │ MCP (stdio | HTTP)
┌──────────────────▼──────────────────┐
│          narajangteo-pro            │
│  ┌────────┐  ┌──────────┐  ┌──────┐ │
│  │ Tools  │→ │Analytics │→ │ DB   │ │
│  └───┬────┘  └────┬─────┘  └──────┘ │
│      └────────────┘                 │
│         ┌──────────┐                │
│         │API Client│                │
│         └────┬─────┘                │
└──────────────┼──────────────────────┘
               │
      ┌─────────▼──────────┐
      │   공공데이터포털    │
      │  나라장터 API 6종   │
      └────────────────────┘

License

MIT