Alphago2580 Naramarketmcp

ai.smitheryPublished by smithery.aiOfficial publisherv1.14.1Updated Oct 24, 2026

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

The publisher's own server: 222wcnm Bilistalkermcp

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Gives an assistant access to Korea's Nara Market (G2B) public procurement data: bid notices, awards, contracts, statistics and shopping-mall products.

What you can do
  • Query bid notices, award results and contract information through the public data standard API
  • Retrieve procurement statistics by year, institution or company
  • Look up product classifications and item lists, and search shopping-mall products by product or company name
  • Browse recent bid announcements and awards by business type with automatic Korean-to-code conversion
  • Explore available API services and operations, and page through large result sets with a data exploration guide
When to use it
Useful when you need Korean public procurement information — tracking bid notices, checking who won a tender, reviewing contract or statistics data, or finding products listed on the Nara Market shopping mall — and want an assistant to query it directly.
Requirements
The manifest lists a remote Smithery endpoint requiring a bearer token in the Authorization header. The README's self-hosted route needs Python 3.10+, the NARAMARKET_SERVICE_KEY environment variable holding a public data portal API service key, and network access to data.go.kr; optional FASTMCP_TRANSPORT, FASTMCP_HOST, FASTMCP_PORT and LOG_LEVEL settings control transport and logging.
Before you install
The server needs a public data portal service key (NARAMARKET_SERVICE_KEY) and, for the hosted endpoint, a Smithery bearer token in the Authorization header; keep both secret. Queries and parameters are sent to data.go.kr and, on the hosted route, through Smithery. The tools appear to be read-only lookups, but verify before relying on that.

Installation

In SourceWeft

  1. Open Alphago2580 Naramarketmcp in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.smithery%2Falphago2580-naramarketmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "alphago2580-naramarketmcp": {
      "type": "http",
      "url": "https://server.smithery.ai/@alphago2580/naramarketmcp/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

나라장터 MCP 서버

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

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

아키텍처

┌─────────────────┐     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종합쇼핑몰 APIMAS 계약, 납품요구, 벤처나라 (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 파라미터 가이드, 값 예시, 검색 패턴
  • 프롬프트: 워크플로우 가이드, 파라미터 선택 가이드, 실전 쿼리 예제

시작하기

필수 요구사항

설치

bash
git clone https://github.com/alphago2580/naramarketmcp.gitcd 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

bash
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.1HTTP/SSE 바인딩 호스트
FASTMCP_PORT-8081HTTP/SSE 포트
LOG_LEVEL-INFO로깅 레벨

프로젝트 구조

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 참조

Source: README.md at commit 79fdfc2

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.14.1LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Smithery integrations

222wcnm Bilistalkermcp

ai.smitheryOfficial publisher

Bilibili creator analysis server that lets an assistant look up a specific user's profile, videos, dynamics, articles, subtitles, followings and comments.

Streamable HTTPWeb executable
Web Search & ScrapingNot indexed yetOct 24, 2026

Zwldarren Akshare One Mcp

ai.smitheryOfficial publisher

Remote MCP server that gives an assistant read-only access to Chinese stock market data: historical and real-time prices, news, and financial statements.

Streamable HTTPWeb executableAuth
FinanceCredential requiredOct 24, 2026

Zhaoganghao Hellomcp

ai.smitheryOfficial publisher

A small remote MCP server that lets an assistant greet people by name and share background on the origin of 'Hello, World'.

Streamable HTTPWeb executable
Not indexed yetOct 24, 2026

Zeta Chain Cli

ai.smitheryOfficial publisher

A remote MCP server that lets an assistant generate friendly, customizable greetings for any name or audience.

Streamable HTTPWeb executableAuth
Credential requiredOct 24, 2026

Yuna0x0 Hackmd Mcp

ai.smitheryOfficial publisher

An MCP server that connects an assistant to the HackMD API so it can read, create, update and delete HackMD notes and manage teams.

Streamable HTTPWeb executable
Productivity & WorkflowNot indexed yetOct 25, 2026