Korean Agriculture Market MCP Server

MCP server for Korean agricultural wholesale market auction data.

Real-time auction prices from 32+ public wholesale markets across South Korea, powered by data.go.kr Open API.

Tools (6)

Tool	Description
`get_realtime_auction`	Real-time auction data (63,000+ daily records nationwide)
`search_product_price`	Search prices by product keyword with market-level summaries
`compare_market_prices`	Compare prices across markets for a product
`get_price_trend`	Price trends over recent N days
`get_market_list`	List of all wholesale markets and category codes
`get_auction_summary`	Daily auction statistics by product and market

Data Coverage

32 wholesale markets across South Korea (Seoul, Busan, Daegu, Daejeon, Gwangju, etc.)
22 product categories: fruits, vegetables, mushrooms, grains, livestock, seafood, etc.
63,000+ auction records per day
Fields: auction time, market, corporation, product, variety, unit price, quantity, packaging, origin

Quick Start

# Clone
git clone https://github.com/higheun/korean-agriculture-mcp.git
cd korean-agriculture-mcp

# Setup
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt  # Windows
# .venv/bin/pip install -r requirements.txt    # Linux/Mac

# Configure API key
cp .env.example .env
# Edit .env with your data.go.kr API key

# Run (stdio mode for Claude Desktop)
python server.py

# Run (SSE mode for remote access)
MCP_TRANSPORT=sse PORT=8000 python server.py

API Key

Get a free API key from data.go.kr:

Sign up at data.go.kr
Search for "전국 공영도매시장 실시간 경매정보"
Apply for API usage (instant approval)
Copy the API key to .env

Claude Desktop Configuration

{
  "mcpServers": {
    "korean-agriculture": {
      "command": "python",
      "args": ["path/to/korean-agriculture-mcp/server.py"],
      "env": {
        "DATA_GO_KR_API_KEY": "your_api_key"
      }
    }
  }
}