naramarket-pro-MCP

Dies ist ein MCP-Server, der 6 Arten von öffentlichen Beschaffungs-APIs von Nara Market (Korea On-line E-Procurement System) integriert. Durch die Verbindung mit MCP-Clients wie Claude Desktop können Sie Ausschreibungen suchen, Marktanalysen durchführen und die Eignung für Ausschreibungen mithilfe natürlicher Sprache bewerten.

Hauptfunktionen

Integration von 6 öffentlichen Beschaffungs-APIs

Wir haben die wichtigsten öffentlichen APIs von Nara Market integriert, um die Abfrage verschiedener Daten zu ermöglichen.

• Ausschreibungen: Suche nach Ausschreibungen basierend auf Schlüsselwörtern, Institutionen und Zeiträumen

• Zuschlaginformationen: Abfrage von erfolgreichen Bietern und Beträgen

• Vertragsinformationen: Überprüfung der tatsächlichen Vertragsabschlüsse

• Integrierte Offenlegung des Vertragsprozesses: Verfolgung des gesamten Fortschritts von der Vorab-Spezifikation bis zum Vertrag

• Beschaffungsanforderungen: Abfrage von Daten in der Phase vor der Auftragsvergabe

• Produkte im 종합쇼핑몰 (General Shopping Mall): Suche nach registrierten Produkten mit Stückpreisverträgen

Der gemeinsame API-Client (api/client.py) verarbeitet die folgenden Funktionen:

• Normalisierung des Antwortformats

• Automatische Wiederholung bei Zeitüberschreitung der Anfrage (maximal 2-mal)

• Speicher-Cache (Standard 5 Minuten)

Konfiguration von 8 MCP-Tools

Wir haben die Funktionen in funktionsbezogene Tools unterteilt, um sie in einer LLM-Umgebung effizient nutzen zu können.

Verarbeitung natürlicher Sprache

Wir haben die Implementierung so vorgenommen, dass Benutzereingaben in alltäglicher Sprache automatisch in API-Parameter umgewandelt werden.

Zeitraum-Ausdrücke — letzte 7 Tage / letzte 3 Monate / dieses Jahr

Betrags-Ausdrücke — 500 Millionen / 150 Millionen / 30 Millionen Won

Synonyme für Arbeitsbereiche — Dienstleistung → Service / Bau → Bauarbeiten

Speicherung des Status

Benutzerkonfigurationsdaten werden auf Basis von SQLite gespeichert. Die gespeicherten Elemente sind die Watchlist und das Unternehmensprofil; der Standardspeicherort ist wie folgt:

~/.narajangteo-pro/state.db

Related MCP server: mcp-kr-g2b

Schnelleinstieg

1. API-Schlüssel ausstellen

Nachdem Sie die Nutzung der folgenden Dienste auf dem Public Data Portal beantragt haben, kopieren Sie den Decoding-Wert des ServiceKey unter Mein Bereich → Entwicklerkonto.

• 조달청_나라장터 입찰공고정보서비스 (Public Procurement Service - Nara Market Bid Notice Information Service)

• 조달청_나라장터 낙찰정보서비스 (Public Procurement Service - Nara Market Bid Award Information Service)

• 조달청_나라장터 계약정보서비스 (Public Procurement Service - Nara Market Contract Information Service)

• 조달청_나라장터 계약과정통합공개서비스 (Public Procurement Service - Nara Market Integrated Contract Process Disclosure Service)

2. Installation

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

# npx
npx narajangteo-pro

# pip
pip install narajangteo-pro
narajangteo-pro

3. Verbindung mit Claude Desktop

Bearbeiten Sie die Konfigurationsdatei unter dem folgenden Pfad:

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

Nach dem Neustart von Claude Desktop können Sie es sofort verwenden.

"Analysiere den Markt für KI-Chatbots im letzten Monat"

"Zeige mir den gesamten Fortschritt von der Vorab-Spezifikation bis zum Vertrag für die Ausschreibungsnummer 20260415123"

"Bewerte, ob wir uns mit unserem Unternehmensprofil für diese Ausschreibung bewerben sollten"

Architektur

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

Lizenz

MIT