naramarket-pro-MCP

Este es un servidor MCP que integra 6 tipos de APIs de contratación pública de Nara Market (나라장터). Al conectarlo con clientes MCP como Claude Desktop, puede realizar búsquedas de anuncios de licitación, análisis de mercado y evaluaciones de idoneidad de ofertas utilizando lenguaje natural.

Funciones principales

Integración de 6 APIs de contratación pública

Se ha configurado para consultar diversos datos integrando las principales APIs públicas de Nara Market.

• Anuncios de licitación: Búsqueda de anuncios por palabras clave, institución y periodo.

• Información de adjudicación: Consulta de empresas adjudicatarias y montos.

• Información de contratos: Verificación de los detalles de los contratos firmados.

• Divulgación integrada del proceso de contratación: Seguimiento de todo el proceso desde las especificaciones previas hasta el contrato.

• Solicitudes de contratación: Consulta de datos en la etapa previa a la licitación.

• Artículos del centro comercial integral: Búsqueda de artículos registrados en contratos de precio unitario.

El cliente de API común (api/client.py) gestiona las siguientes funciones:

• Normalización del formato de respuesta.

• Reintento automático en caso de tiempo de espera agotado (máximo 2 veces).

• Caché en memoria (5 minutos por defecto).

Configuración de 8 herramientas MCP

Se ha organizado en herramientas por función para un uso eficiente en entornos LLM.

Procesamiento de entrada en lenguaje natural

Se ha implementado para que, incluso si el usuario ingresa expresiones cotidianas, estas se conviertan automáticamente en parámetros de API.

Expresiones de periodo — últimos 7 días / últimos 3 meses / este año

Expresiones de monto — 500 millones / 150 millones / 30 millones

Sinónimos de categorías de trabajo — servicio → servicios / construcción → obras

Almacenamiento de estado

Los datos de configuración del usuario se guardan basándose en SQLite. Los elementos guardados son la lista de seguimiento (Watchlist) y el perfil de la empresa; la ubicación de almacenamiento predeterminada es la siguiente:

~/.narajangteo-pro/state.db

Related MCP server: mcp-kr-g2b

Inicio rápido

1. Emisión de clave API

Después de solicitar el uso de los siguientes servicios en el Portal de Datos Públicos, copie el valor de decodificación de la ServiceKey en Mi página → Cuenta de desarrollador.

• Servicio de información de anuncios de licitación de Nara Market del Servicio de Contratación Pública

• Servicio de información de adjudicación de Nara Market del Servicio de Contratación Pública

• Servicio de información de contratos de Nara Market del Servicio de Contratación Pública

• Servicio de divulgación integrada del proceso de contratación de Nara Market del Servicio de Contratación Pública

2. Instalación

# uvx (권장 — Python 설치 없이 실행)
uvx narajangteo-pro

# npx
npx narajangteo-pro

# pip
pip install narajangteo-pro
narajangteo-pro

3. Conexión con Claude Desktop

Modifique el archivo de configuración en la siguiente ruta:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "narajangteo-pro": {
      "command": "uvx",
      "args": ["narajangteo-pro@latest"],
      "env": {
        "NARA_API_KEY": "발급받은_디코딩_서비스키"
      }
    }
  }
}

Al reiniciar Claude Desktop, podrá utilizarlo inmediatamente.

"Analiza el mercado del sector de chatbots de IA del último mes"

"Muestra el progreso completo desde las especificaciones previas hasta el contrato para el número de anuncio 20260415123"

"Evalúa si deberíamos licitar para este anuncio con el perfil de nuestra empresa"

Arquitectura

┌─────────────────────────────────────┐
│  Claude Desktop / Cursor / VS Code  │
└──────────────────┬──────────────────┘
                   │ MCP (stdio | HTTP)
┌──────────────────▼──────────────────┐
│          narajangteo-pro            │
│  ┌────────┐  ┌──────────┐  ┌──────┐ │
│  │ Tools  │→ │Analytics │→ │ DB   │ │
│  └───┬────┘  └────┬─────┘  └──────┘ │
│      └────────────┘                 │
│         ┌──────────┐                │
│         │API Client│                │
│         └────┬─────┘                │
└──────────────┼──────────────────────┘
               │
      ┌─────────▼──────────┐
      │   공공데이터포털    │
      │  나라장터 API 6종   │
      └────────────────────┘

Licencia

MIT