naramarket-pro-MCP

Это MCP-сервер, объединяющий 6 видов API государственных закупок Nara Market (Nara Jangteo). Подключив его к MCP-клиенту, такому как Claude Desktop, вы можете выполнять поиск тендеров, анализ рынка и оценку пригодности для участия в торгах с помощью естественного языка.

Основные функции

Интеграция 6 видов API государственных закупок

Мы объединили основные публичные API Nara Market для обеспечения возможности поиска различных данных.

• Тендерные объявления: поиск объявлений по ключевым словам, организациям и периодам

• Информация о результатах торгов: поиск компаний-победителей и сумм контрактов

• Информация о контрактах: проверка фактических сведений о заключенных контрактах

• Интегрированное раскрытие процесса закупок: отслеживание всего процесса от предварительных спецификаций до заключения контракта

• Запросы на закупки: поиск данных на этапе до размещения заказа

• Товары в комплексном торговом центре: поиск товаров, зарегистрированных по контрактам с фиксированной ценой

Общий API-клиент (api/client.py) обрабатывает следующие функции:

• Нормализация формата ответов

• Автоматический повтор при тайм-ауте запроса (максимум 2 раза)

• Кэширование в памяти (по умолчанию 5 минут)

Состав из 8 инструментов MCP

Функционал разделен на инструменты для эффективного использования в среде LLM.

Обработка ввода на естественном языке

Реализовано автоматическое преобразование повседневных выражений пользователя в параметры API.

Выражения периода — последние 7 дней / последние 3 месяца / в этом году

Выражения суммы — 500 млн / 150 млн / 30 млн вон

Синонимы категорий работ — сервис → услуги / строительство → подрядные работы

Сохранение состояния

Данные настроек пользователя сохраняются на основе SQLite. Сохраняемые элементы включают список отслеживания (Watchlist) и профиль компании, расположение по умолчанию указано ниже.

~/.narajangteo-pro/state.db

Related MCP server: mcp-kr-g2b

Быстрый старт

1. Получение API-ключа

После подачи заявки на использование услуг на Портале государственных данных, скопируйте декодированное значение ServiceKey в разделе «Моя страница» → «Учетная запись разработчика».

• Служба информации о тендерных объявлениях Nara Market (Служба закупок)

• Служба информации о результатах торгов Nara Market (Служба закупок)

• Служба информации о контрактах Nara Market (Служба закупок)

• Служба интегрированного раскрытия процесса закупок Nara Market (Служба закупок)

2. Установка

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

# npx
npx narajangteo-pro

# pip
pip install narajangteo-pro
narajangteo-pro

3. Подключение к Claude Desktop

Отредактируйте файл конфигурации по указанному пути:

• 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": "발급받은_디코딩_서비스키"
      }
    }
  }
}

После перезапуска Claude Desktop вы сможете сразу начать работу.

"Проанализируй рынок в сфере AI-чат-ботов за последний месяц"

"Покажи весь процесс от предварительной спецификации до контракта для объявления № 20260415123"

"Оцени, стоит ли нашей компании участвовать в этом тендере, основываясь на нашем профиле"

Архитектура

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

Лицензия

MIT