# alphago2580-naramarketmcp

alphago2580-naramarketmcp is an MCP server for Claude Code that exposes Korea’s public procurement data, including bids, contracts, and statistics. It connects over HTTP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: alphago2580
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alphago2580/naramarketmcp
- Updated: 2026-02-09
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/alphago2580-naramarketmcp

## What it does

alphago2580-naramarketmcp gives an AI agent MCP access to G2B procurement data. Its tools cover bid notices, award results, contracts, procurement statistics, product catalogs, and shopping-mall records. Separate helpers handle recent bids, winners by business type, yearly statistics, and product searches.

The server includes 16 tools, 3 resources, and 3 prompts for API parameters, search patterns, and workflow guidance. It supports STDIO, HTTP, and SSE, with deployment options through Docker and Smithery.ai.

A local run needs Python 3.10+ and the `NARAMARKET_SERVICE_KEY` API key from `data.go.kr`. Requests to the government APIs require that key.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://server.smithery.ai/@alphago2580/naramarketmcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http alphago2580-naramarketmcp https://server.smithery.ai/@alphago2580/naramarketmcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add alphago2580-naramarketmcp --url https://server.smithery.ai/@alphago2580/naramarketmcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alphago2580-naramarketmcp": {
            "url": "https://server.smithery.ai/@alphago2580/naramarketmcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alphago2580-naramarketmcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@alphago2580/naramarketmcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http alphago2580-naramarketmcp https://server.smithery.ai/@alphago2580/naramarketmcp/mcp
```

## When to use it
- find recent public procurement bid notices
- retrieve award results by business type
- compare procurement statistics by year
- search products by name or supplier
- inspect API operations and paginated data

## Example prompts
- Find recent public procurement bid notices for the requested period.
- Show award results for this business type and explain the returned records.
- Search the shopping mall for products matching this name or supplier.

## Similar
- [OCDS German Procurement Search](https://affpapa.org/en/nevibecode/mcp/ocds-german-procurement-search.md) — MCP server · ★ 5 repo stars
- [SAM.gov](https://affpapa.org/en/nevibecode/mcp/samgov.md) — MCP server · ★ 34 repo stars
- [otwarte-dane](https://affpapa.org/en/nevibecode/skills/otwarte-dane.md) — skill · ★ 60 repo stars
- [UnifAPI](https://affpapa.org/en/nevibecode/mcp/unifapi.md) — MCP server · ★ 4 repo stars
- [ResultRail by LarryBuildsAI](https://affpapa.org/en/nevibecode/mcp/resultrail-by-larrybuildsai.md) — MCP server · 6708 installs
- [adresy](https://affpapa.org/en/nevibecode/skills/adresy.md) — skill · ★ 60 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
