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"
      }
    }
  }
}

Example Queries

"Show me today's apple auction prices at Seoul Garak market"
"Compare strawberry prices across all markets"
"What's the price trend for Napa cabbage over the past week?"
"Give me an auction summary for Daejeon Noeun market"

Data Source

data.go.kr - Korean Agricultural Products Wholesale Market Real-time Auction Info
API: https://apis.data.go.kr/B552845/katRealTime2/trades2

License

MIT

korean-agriculture-mcp