S
SkillNav

ai.smithery/alphago2580-naramarketmcp

AI 与智能体

by alphago2580

访问韩国 G2B 采购与 Nara Market 数据，涵盖招标公告、中标结果、合同及统计等关键业务信息。

2GitHub

什么是 ai.smithery/alphago2580-naramarketmcp？

访问韩国 G2B 采购与 Nara Market 数据，涵盖招标公告、中标结果、合同及统计等关键业务信息。

README

나라장터 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종합쇼핑몰 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.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

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로깅 레벨

프로젝트 구조

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

常见问题

ai.smithery/alphago2580-naramarketmcp 是什么？

访问韩国 G2B 采购与 Nara Market 数据，涵盖招标公告、中标结果、合同及统计等关键业务信息。

相关 Skills

Claude接口

by anthropics

Universal
热门

面向接入 Claude API、Anthropic SDK 或 Agent SDK 的开发场景，自动识别项目语言并给出对应示例与默认配置，快速搭建 LLM 应用。

✎ 想把Claude能力接进应用或智能体，用claude-api上手快、兼容Anthropic与Agent SDK，集成路径清晰又省心

AI 与智能体
未扫描171.4k

RAG架构师

by alirezarezvani

Universal
热门

聚焦生产级RAG系统设计与优化，覆盖文档切块、检索链路、索引构建、召回评估等关键环节，适合搭建可扩展、高准确率的知识库问答与检索增强应用。

✎ 面向RAG落地，把知识库、向量检索和生成链路系统串联起来，做架构设计时更清晰，也更少踩坑。

AI 与智能体
未扫描24.9k

多智能体架构

by alirezarezvani

Universal
热门

聚焦多智能体系统架构设计，梳理 Supervisor、Swarm、分层和 Pipeline 等模式，覆盖角色定义、通信协作与性能评估，适合规划稳健可扩展的 AI agent 编排方案。

✎ 帮你系统解决多智能体应用的架构设计与协同编排难题，适合构建复杂 AI 工作流，成熟度高、社区认可也很亮眼。

AI 与智能体
未扫描24.9k

相关 MCP Server

知识图谱记忆

编辑精选

by Anthropic

热门

Memory 是一个基于本地知识图谱的持久化记忆系统，让 AI 记住长期上下文。

✎ 帮 AI 和智能体补上“记不住”的短板，用本地知识图谱沉淀长期上下文，连续对话更聪明，数据也更可控。

AI 与智能体
89.7k

顺序思维

编辑精选

by Anthropic

热门

Sequential Thinking 是让 AI 通过动态思维链解决复杂问题的参考服务器。

✎ 这个服务器展示了如何让 Claude 像人类一样逐步推理，适合开发者学习 MCP 的思维链实现。但注意它只是个参考示例，别指望直接用在生产环境里。

AI 与智能体
89.2k

Codebase Memory

by deusdata

热门

持久化的代码库知识图谱，可跨会话保留上下文，在 session 重启或上下文压缩后仍能继续使用。

✎ 专治 AI 编程助手“会话失忆”，把代码库沉淀为持久知识图谱，重启或压缩上下文后也能无缝续上开发状态。

AI 与智能体
37.3k

评论