Alphago2580 Naramarketmcp

ai.smithery由 smithery.ai 發布官方發布者v1.14.1更新於 Oct 24, 2026

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

發布方自己的服務：222wcnm Bilistalkermcp

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

讓助理存取韓國 Nara Market（G2B）公共採購資料：招標公告、決標資訊、契約、統計與綜合購物中心商品。

可以做什麼
  • 透過公共資料標準 API 查詢招標公告、決標資訊與契約內容
  • 依年度、機關或企業取得採購統計資料
  • 查詢物品分類與品項清單，並依產品名稱或企業名稱搜尋購物中心商品
  • 查看近期招標公告，並依業務類型查詢決標資訊（韓文自動轉代碼）
  • 瀏覽可用的 API 服務與操作，並搭配資料探索指南分頁取得大量資料
適用情境
需要韓國公共採購資訊時適用，例如追蹤招標公告、查詢得標者、檢視契約或統計資料，或在 Nara Market 綜合購物中心尋找商品，並希望由助理直接查詢。
執行需求
清單顯示為 Smithery 遠端端點，需在 Authorization 標頭提供 bearer 權杖。README 的自架方式需要 Python 3.10+、存放公共資料入口 API 服務金鑰的環境變數 NARAMARKET_SERVICE_KEY，以及連線 data.go.kr 的網路；選用的 FASTMCP_TRANSPORT、FASTMCP_HOST、FASTMCP_PORT 與 LOG_LEVEL 可控制傳輸與日誌。
安裝前請注意
需要公共資料入口服務金鑰（NARAMARKET_SERVICE_KEY），託管端點另需 Authorization 標頭中的 Smithery bearer 權杖，兩者都應保密。查詢與參數會傳送至 data.go.kr，託管方式下還會經過 Smithery。所列工具看起來是唯讀查詢，但使用前請自行確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Alphago2580 Naramarketmcp，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/ai.smithery%2Falphago2580-naramarketmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源：README.md，提交 79fdfc2

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.14.1最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Smithery 整合

222wcnm Bilistalkermcp

ai.smithery官方發布者

Bilibili 創作者分析伺服器，讓助理查詢指定使用者的個人資料、影片、動態、專欄、字幕、追蹤清單與留言。

Streamable HTTP可網頁執行
網頁搜尋與抓取尚未收錄Oct 24, 2026

Zwldarren Akshare One Mcp

ai.smithery官方發布者

遠端 MCP 伺服器，讓助理以唯讀方式取得中國股市資料：歷史與即時行情、新聞和財務報表。

Streamable HTTP可網頁執行驗證方式
金融需要憑證Oct 24, 2026

Zhaoganghao Hellomcp

ai.smithery官方發布者

一個小型遠端 MCP 伺服器，讓助理依名字向人問候，並介紹「Hello, World」的由來。

Streamable HTTP可網頁執行
尚未收錄Oct 24, 2026

Zeta Chain Cli

ai.smithery官方發布者

一個遠端 MCP 伺服器，讓助理為任意姓名或受眾產生友善、可自訂的問候語。

Streamable HTTP可網頁執行驗證方式
需要憑證Oct 24, 2026

Yuna0x0 Hackmd Mcp

ai.smithery官方發布者

一個連接 HackMD API 的 MCP 伺服器，讓助理讀取、建立、更新和刪除 HackMD 筆記並管理團隊。

Streamable HTTP可網頁執行
效率與工作流尚未收錄Oct 25, 2026