π¦
ai.smithery/alphago2580-naramarketmcp
Access Koreaβs G2B procurement and Nara Market data for bid notices, awards, contracts, statisticsβ¦
0 installs
Trust: 34 β Low
Devtools
Ask AI about ai.smithery/alphago2580-naramarketmcp
Powered by Claude Β· Grounded in docs
I know everything about ai.smithery/alphago2580-naramarketmcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
λλΌμ₯ν° 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 | μ’ ν©μΌνλͺ° 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 μλΉμ€ ν€
μ€μΉ
git clone https://github.com/alphago2580/naramarketmcp.git
cd naramarketmcp
# νκ²½ μ€μ
cp .env.example .env
# .envμμ NARAMARKET_SERVICE_KEY μ€μ
# μμ‘΄μ± μ€μΉ
pip install -r requirements.txt
μ€ν
# STDIO λͺ¨λ (MCP ν΄λΌμ΄μΈνΈ μ°λ)
python -m src.main
# HTTP λͺ¨λ (μΉ μλΉμ€)
FASTMCP_TRANSPORT=http FASTMCP_PORT=8000 python -m src.main
# ν¨ν€μ§ μ€μΉ ν μ€ν
pip install .
naramarket-mcp
Docker
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 | λ‘κΉ λ 벨 |
νλ‘μ νΈ κ΅¬μ‘°
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
κ°λ°
# κ°λ° μμ‘΄μ± μ€μΉ
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 μ°Έμ‘°
