Alphago2580 Naramarketmcp

Access Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for alphago2580-naramarketmcp, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Documentation Overview

나라장터 MCP 서버

한국 공공조달(G2B) 데이터를 MCP(Model Context Protocol)로 제공하는 FastMCP 2.0 서버입니다.

입찰공고, 낙찰정보, 계약정보, 조달통계, 물품목록, 종합쇼핑몰 등 나라장터의 주요 API를 AI 에이전트가 바로 사용할 수 있도록 통합했습니다.

아키텍처

Code

┌─────────────────┐     MCP Protocol      ┌──────────────────────┐
│   AI Agent      │ ◄──(stdio/http/sse)──► │  naramarket-mcp      │
│ (Claude, etc.)  │                        │                      │
└─────────────────┘                        │  ┌────────────────┐  │
                                           │  │ MCP Tools (16) │  │
                                           │  │ Resources (3)  │  │
                                           │  │ Prompts (3)    │  │
                                           │  └───────┬────────┘  │
                                           │          │           │
                                           │  ┌───────▼────────┐  │
                                           │  │  API Clients   │  │
                                           │  │  (sync/async)  │  │
                                           │  └───────┬────────┘  │
                                           └──────────┼───────────┘
                                                      │
                                           ┌──────────▼───────────┐
                                           │  data.go.kr APIs     │
                                           │  (공공데이터포털)      │
                                           └──────────────────────┘

MCP 도구

기본 도구 (3개)

도구	설명
`crawl_list`	나라장터 상품 목록 조회
`get_detailed_attributes`	상품 상세 속성 조회
`server_info`	서버 정보 및 사용 가능한 도구 목록

정부조달 API (4개)

도구	설명	지원 API
`call_public_data_standard_api`	공공데이터개방표준 API	입찰공고, 낙찰정보, 계약정보
`call_procurement_statistics_api`	조달통계 API	전체/기관별/기업별 조달 통계 (14개 오퍼레이션)
`call_product_list_api`	물품목록 API	물품분류, 품목 조회 (12개 오퍼레이션)
`call_shopping_mall_api`	종합쇼핑몰 API	MAS 계약, 납품요구, 벤처나라 (9개 오퍼레이션)

AI 친화 간편 도구 (4개)

도구	설명
`get_recent_bid_announcements`	최근 입찰공고 조회 (기간 자동 계산)
`get_successful_bids_by_business_type`	업무구분별 낙찰정보 (한글 → 코드 자동 변환)
`get_procurement_statistics_by_year`	연도별 조달통계
`search_shopping_mall_products`	쇼핑몰 제품 검색 (제품명/업체명)

탐색 도구 (4개)

도구	설명
`get_all_api_services_info`	전체 서비스 및 오퍼레이션 목록
`get_api_operations`	서비스별 세부 오퍼레이션 조회
`call_api_with_pagination_support`	페이징 지원 대량 데이터 탐색
`get_data_exploration_guide`	데이터 탐색 전략 가이드

MCP 리소스 & 프롬프트

리소스: API 파라미터 가이드, 값 예시, 검색 패턴
프롬프트: 워크플로우 가이드, 파라미터 선택 가이드, 실전 쿼리 예제

시작하기

필수 요구사항

Python 3.10+
공공데이터포털 API 서비스 키

설치

bash

git clone https://github.com/alphago2580/naramarketmcp.git
cd naramarketmcp

# 환경 설정
cp .env.example .env
# .env에서 NARAMARKET_SERVICE_KEY 설정

# 의존성 설치
pip install -r requirements.txt

실행

bash

# STDIO 모드 (MCP 클라이언트 연동)
python -m src.main

# HTTP 모드 (웹 서비스)
FASTMCP_TRANSPORT=http FASTMCP_PORT=8000 python -m src.main

# 패키지 설치 후 실행
pip install .
naramarket-mcp

Docker

Terminal

docker build -t naramarket-mcp .
docker run --rm -e NARAMARKET_SERVICE_KEY=your-key -p 8000:8000 naramarket-mcp

환경 변수

변수	필수	기본값	설명
`NARAMARKET_SERVICE_KEY`	✅	-	공공데이터포털 API 키
`FASTMCP_TRANSPORT`	-	`stdio`	전송 모드 (`stdio`, `http`, `sse`)
`FASTMCP_HOST`	-	`127.0.0.1`	HTTP/SSE 바인딩 호스트
`FASTMCP_PORT`	-	`8081`	HTTP/SSE 포트
`LOG_LEVEL`	-	`INFO`	로깅 레벨

프로젝트 구조

Code

naramarketmcp/
├── src/
│   ├── main.py              # FastMCP 서버 진입점 (도구/리소스/프롬프트 등록)
│   ├── core/                # 핵심 모듈
│   │   ├── config.py        # 설정 관리
│   │   ├── models.py        # 데이터 모델
│   │   ├── client.py        # API 클라이언트
│   │   ├── async_client.py  # 비동기 클라이언트
│   │   └── utils.py         # 유틸리티
│   ├── api/                 # HTTP/REST 인터페이스
│   ├── services/            # 비즈니스 로직 (크롤러, 인증)
│   └── tools/               # MCP 도구 구현
│       ├── naramarket.py    # 기본 나라장터 도구
│       ├── enhanced_tools.py # 확장 API 도구
│       └── openapi_tools.py # G2B OpenAPI 도구
├── tests/                   # 테스트
├── deployments/             # 배포 설정 (docker-compose, nginx)
├── Dockerfile
├── smithery.yaml            # Smithery.ai 배포 설정
├── pyproject.toml
└── requirements.txt

개발

bash

# 개발 의존성 설치
pip install .[dev]

# 테스트 실행
pytest tests/

# 타입 체크
mypy src/

기술 스택

FastMCP 2.0 — MCP 서버 프레임워크
Requests / Pandas — API 호출 및 데이터 처리
Uvicorn / Starlette — HTTP/SSE 서빙
Docker — 컨테이너 배포
Smithery.ai — 클라우드 MCP 호스팅

라이선스

Apache License 2.0 — LICENSE 참조

Read the full README →View source on GitHub →

Related MCP Servers

View all in Legal View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

7mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Alphago2580 Naramarketmcp

We don't have a confirmed install command for alphago2580-naramarketmcp yet, so we don't publish a generated one — a guessed package name would point at the wrong package or none at all. Follow the project's own README or setup instructions (https://github.com/alphago2580/naramarketmcp) for the current steps.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Alphago2580 Naramarketmcp AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/alphago2580-naramarketmcp?style=directory)](https://allmcps.com/mcp/alphago2580-naramarketmcp)

HTML Embed

<a href="https://allmcps.com/mcp/alphago2580-naramarketmcp"><img src="https://allmcps.com/api/badge/alphago2580-naramarketmcp?style=directory" alt="Alphago2580 Naramarketmcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryLegal

5/5 checks healthy over the last 45d

31Quality signal: Emerging · 31/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools12/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ⚖️ Legal →Best MCP servers for Legal →Alternatives to Alphago2580 Naramarketmcp →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Alphago2580 Naramarketmcp

Access Korea’s G2B procurement and Nara Market data for bid notices, awards, contracts, statistics…

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Documentation Overview

나라장터 MCP 서버

한국 공공조달(G2B) 데이터를 MCP(Model Context Protocol)로 제공하는 FastMCP 2.0 서버입니다.

입찰공고, 낙찰정보, 계약정보, 조달통계, 물품목록, 종합쇼핑몰 등 나라장터의 주요 API를 AI 에이전트가 바로 사용할 수 있도록 통합했습니다.

아키텍처

Code

┌─────────────────┐     MCP Protocol      ┌──────────────────────┐
│   AI Agent      │ ◄──(stdio/http/sse)──► │  naramarket-mcp      │
│ (Claude, etc.)  │                        │                      │
└─────────────────┘                        │  ┌────────────────┐  │
                                           │  │ MCP Tools (16) │  │
                                           │  │ Resources (3)  │  │
                                           │  │ Prompts (3)    │  │
                                           │  └───────┬────────┘  │
                                           │          │           │
                                           │  ┌───────▼────────┐  │
                                           │  │  API Clients   │  │
                                           │  │  (sync/async)  │  │
                                           │  └───────┬────────┘  │
                                           └──────────┼───────────┘
                                                      │
                                           ┌──────────▼───────────┐
                                           │  data.go.kr APIs     │
                                           │  (공공데이터포털)      │
                                           └──────────────────────┘

MCP 도구

기본 도구 (3개)

도구	설명
`crawl_list`	나라장터 상품 목록 조회
`get_detailed_attributes`	상품 상세 속성 조회
`server_info`	서버 정보 및 사용 가능한 도구 목록

정부조달 API (4개)

도구	설명	지원 API
`call_public_data_standard_api`	공공데이터개방표준 API	입찰공고, 낙찰정보, 계약정보
`call_procurement_statistics_api`	조달통계 API	전체/기관별/기업별 조달 통계 (14개 오퍼레이션)
`call_product_list_api`	물품목록 API	물품분류, 품목 조회 (12개 오퍼레이션)
`call_shopping_mall_api`	종합쇼핑몰 API	MAS 계약, 납품요구, 벤처나라 (9개 오퍼레이션)

AI 친화 간편 도구 (4개)

도구	설명
`get_recent_bid_announcements`	최근 입찰공고 조회 (기간 자동 계산)
`get_successful_bids_by_business_type`	업무구분별 낙찰정보 (한글 → 코드 자동 변환)
`get_procurement_statistics_by_year`	연도별 조달통계
`search_shopping_mall_products`	쇼핑몰 제품 검색 (제품명/업체명)

탐색 도구 (4개)

도구	설명
`get_all_api_services_info`	전체 서비스 및 오퍼레이션 목록
`get_api_operations`	서비스별 세부 오퍼레이션 조회
`call_api_with_pagination_support`	페이징 지원 대량 데이터 탐색
`get_data_exploration_guide`	데이터 탐색 전략 가이드

MCP 리소스 & 프롬프트

리소스: API 파라미터 가이드, 값 예시, 검색 패턴
프롬프트: 워크플로우 가이드, 파라미터 선택 가이드, 실전 쿼리 예제

시작하기

필수 요구사항

Python 3.10+
공공데이터포털 API 서비스 키

설치

bash

git clone https://github.com/alphago2580/naramarketmcp.git
cd naramarketmcp

# 환경 설정
cp .env.example .env
# .env에서 NARAMARKET_SERVICE_KEY 설정

# 의존성 설치
pip install -r requirements.txt

실행

bash

# STDIO 모드 (MCP 클라이언트 연동)
python -m src.main

# HTTP 모드 (웹 서비스)
FASTMCP_TRANSPORT=http FASTMCP_PORT=8000 python -m src.main

# 패키지 설치 후 실행
pip install .
naramarket-mcp

Docker

Terminal

docker build -t naramarket-mcp .
docker run --rm -e NARAMARKET_SERVICE_KEY=your-key -p 8000:8000 naramarket-mcp

환경 변수

변수	필수	기본값	설명
`NARAMARKET_SERVICE_KEY`	✅	-	공공데이터포털 API 키
`FASTMCP_TRANSPORT`	-	`stdio`	전송 모드 (`stdio`, `http`, `sse`)
`FASTMCP_HOST`	-	`127.0.0.1`	HTTP/SSE 바인딩 호스트
`FASTMCP_PORT`	-	`8081`	HTTP/SSE 포트
`LOG_LEVEL`	-	`INFO`	로깅 레벨

프로젝트 구조

Code

naramarketmcp/
├── src/
│   ├── main.py              # FastMCP 서버 진입점 (도구/리소스/프롬프트 등록)
│   ├── core/                # 핵심 모듈
│   │   ├── config.py        # 설정 관리
│   │   ├── models.py        # 데이터 모델
│   │   ├── client.py        # API 클라이언트
│   │   ├── async_client.py  # 비동기 클라이언트
│   │   └── utils.py         # 유틸리티
│   ├── api/                 # HTTP/REST 인터페이스
│   ├── services/            # 비즈니스 로직 (크롤러, 인증)
│   └── tools/               # MCP 도구 구현
│       ├── naramarket.py    # 기본 나라장터 도구
│       ├── enhanced_tools.py # 확장 API 도구
│       └── openapi_tools.py # G2B OpenAPI 도구
├── tests/                   # 테스트
├── deployments/             # 배포 설정 (docker-compose, nginx)
├── Dockerfile
├── smithery.yaml            # Smithery.ai 배포 설정
├── pyproject.toml
└── requirements.txt

개발

bash

# 개발 의존성 설치
pip install .[dev]

# 테스트 실행
pytest tests/

# 타입 체크
mypy src/

기술 스택

FastMCP 2.0 — MCP 서버 프레임워크
Requests / Pandas — API 호출 및 데이터 처리
Uvicorn / Starlette — HTTP/SSE 서빙
Docker — 컨테이너 배포
Smithery.ai — 클라우드 MCP 호스팅

라이선스

Apache License 2.0 — LICENSE 참조

Read the full README →View source on GitHub →

Related MCP Servers

View all in Legal View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

7mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Alphago2580 Naramarketmcp

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/alphago2580-naramarketmcp?style=directory)](https://allmcps.com/mcp/alphago2580-naramarketmcp)

HTML Embed

<a href="https://allmcps.com/mcp/alphago2580-naramarketmcp"><img src="https://allmcps.com/api/badge/alphago2580-naramarketmcp?style=directory" alt="Alphago2580 Naramarketmcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryLegal

5/5 checks healthy over the last 45d

31Quality signal: Emerging · 31/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools12/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ⚖️ Legal →Best MCP servers for Legal →Alternatives to Alphago2580 Naramarketmcp →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients