Alphago2580 Naramarketmcp

What alphago2580-naramarketmcp MCP server does

alphago2580-naramarketmcp MCP server exposes Korea’s 나라장터 (Nara Market) and related public procurement data through the Model Context Protocol. The data comes from APIs published through Korea’s public data portal, data.go.kr. Supported areas include bid announcements, successful bids, contract records, procurement statistics, product classifications and items, and comprehensive shopping-mall information such as MAS contracts, delivery requests, and Venture Nara data.

The server is intended for AI agents that need structured access to procurement information rather than a browser-only workflow. It includes both lower-level API callers and convenience tools that handle common query preparation, such as calculating a recent date range or converting Korean business-category values into API codes.

How it works

An MCP client communicates with the FastMCP application over stdio, HTTP, or SSE. The server then uses synchronous or asynchronous API clients to request data from data.go.kr and returns the results through MCP tools. HTTP and SSE settings include a configurable bind host and port; stdio is the default transport.

alphago2580-naramarketmcp MCP server also provides three resource types covering API parameters, example values, and search patterns. Three prompts supply workflow guidance, parameter-selection help, and practical query examples. Exploration tools can list available services and operations, describe operations for a selected service, support paginated investigation of larger result sets, and provide a data-exploration guide.

Setup and configuration

Use Python 3.10 or newer and obtain a service key from the Korean public data portal. After cloning the repository, install the dependencies from requirements.txt, copy .env.example to .env, and set NARAMARKET_SERVICE_KEY to the issued key.

The default launch command is python -m src.main, which uses stdio. To serve over HTTP, set FASTMCP_TRANSPORT=http and optionally configure FASTMCP_HOST and FASTMCP_PORT. The transport setting also accepts sse. The project can alternatively be installed with pip install . and started with naramarket-mcp, or built and run as a Docker image with the service key passed into the container.

LOG_LEVEL controls logging verbosity and defaults to INFO. The documented defaults are stdio for transport, 127.0.0.1 for the host, and 8081 for the port.

Tools and capabilities

The documented tool groups include:

• crawl_list for Nara Market product listings and get_detailed_attributes for product attributes.
• call_public_data_standard_api for bid, award, and contract APIs.
• call_procurement_statistics_api for overall, agency-level, and company-level procurement statistics.
• call_product_list_api for product classifications and item queries.
• call_shopping_mall_api for shopping-mall procurement data.
• get_recent_bid_announcements, get_successful_bids_by_business_type, get_procurement_statistics_by_year, and search_shopping_mall_products for common queries.
• server_info, service and operation discovery, and paginated API exploration tools for understanding the available interface.

alphago2580-naramarketmcp MCP server fits workflows such as monitoring recent Korean government tenders, reviewing awards by business category, comparing annual procurement statistics, or finding products by name or supplier.