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