{"type": "text"}

Gyeongbuk MCP

Dies ist ein FastMCP-Server, der KI-Agenten mit regionalen und öffentlichen Daten aus Gyeongbuk versorgt.

Derzeit werden Werkzeuge für Krankenhäuser, Bushaltestellen, traditionelle Märkte, altersspezifische Bevölkerungsanteile, regionale Sicherheitsstufen sowie Empfehlungen für marktzentrierte Lebensräume für ältere Menschen ohne Auto bereitgestellt. Der Standardausführungsmodus konvertiert die Originaldateien der öffentlichen Daten in SQLite und fragt sie ab, sodass weder API-Authentifizierungsschlüssel noch eine Verbindung zu externen Servern erforderlich sind. Informationen zu Eingaben, Ausgaben und Datenbeschränkungen der einzelnen Werkzeuge finden Sie in docs/.

Schnellstart

Erforderlich sind Python 3.12 oder höher und uv.

make sync
make data-setup
make run

make data-setup lädt die in data/sources.toml festgelegten offiziellen Quelldateien herunter, prüft SHA-256 und Dateiformat und erstellt anschließend eine lokale SQLite-Datenbank. Ein API-Authentifizierungsschlüssel ist nicht erforderlich. Die Quelldateien und die erzeugte Datenbank sind nicht in Git und den GitHub-Releases enthalten.

Der aus den aktuell heruntergeladenen Quelldateien erzeugte Schnappschuss enthält 3.415 Krankenhäuser und Arztpraxen in Gyeongbuk, 16.031 Fachabteilungen, 29.735 Bushaltestellen in Gyeongbuk, 53 Buslinien und 196 Linienmuster in Pohang, 51 Pohang-Linien mit möglicher Abfahrtsbestimmung, 132 traditionelle Märkte, 3.949 Altersgruppen und 138 regionale Sicherheitsstufen.

Bei Bedarf können Sie die Beispielkonfiguration kopieren. Im Dateimodus ist kein Authentifizierungsschlüssel erforderlich.

cp .env.example .env

DATA_MODE=file
LOCAL_DATABASE_PATH=data/processed/gyeongbuk.sqlite3

Setzen Sie DATA_MODE=api und DATA_GO_KR_SERVICE_KEY nur, wenn Sie den API-Modus vorübergehend verwenden. Der API-Modus gilt nur für die Abfrage von Krankenhäusern, Bushaltestellen und Märkten; die Werkzeuge für Bevölkerung und Sicherheit verwenden weiterhin die lokale SQLite-Datenbank. .env ist von Git ausgeschlossen, und gleichnamige Shell- und CI-Umgebungsvariablen haben Vorrang vor .env.

Related MCP server: power-plan-db

MCP-Client-Registrierung

Registrieren Sie den Server wie folgt in der stdio-MCP-Konfiguration. Ersetzen Sie /absolute/path/gyeongbuk-mcp durch den tatsächlichen absoluten Pfad des Repositorys.

{
  "mcpServers": {
    "gyeongbuk": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/gyeongbuk-mcp",
        "run",
        "fastmcp",
        "run",
        "src/server.py"
      ]
    }
  }
}

Befehle

make run          # stdio MCP 서버 실행
make data-fetch   # 고정된 공식 원본 다운로드·검증
make data-check   # 네트워크 없이 기존 원본 검증
make data         # 기존 원본에서 로컬 SQLite 재생성
make data-setup   # 원본 다운로드 후 SQLite 생성
make format       # Ruff로 포매팅
make format-check # 포맷 변경 없이 검사
make lint         # Ruff 린트
make typecheck    # mypy 타입 체크
make test         # pytest 테스트
make audit        # Python 의존성 취약점 검사
make check        # 포맷, 린트, 타입, 테스트 전체 검사
make pre-commit   # 모든 파일에 pre-commit 훅 실행

Jeder Befehl kann auch direkt mit uv run ... ausgeführt werden.

Informationen zur Mitarbeit an der Entwicklung finden Sie in CONTRIBUTING.md, und Sicherheitslücken melden Sie bitte über SECURITY.md.

Struktur

src/
├── server.py       # FastMCP 서버 진입점
├── tools/          # MCP 도구 정의
├── services/       # 비즈니스 로직
├── clients/        # 외부 API 클라이언트
└── models/         # 입력/출력 모델
tests/
docs/                 # 도구 계약, 데이터 출처, 구현 계획
data/
├── raw/              # 직접 내려받은 원본(커밋 제외)
├── reference/        # 출처가 명시된 작은 보조 매핑
└── processed/        # 생성된 SQLite(커밋 제외)
scripts/
└── build_snapshot.py # 파일 정규화 진입점

Lizenz

Der Quellcode wird unter der MIT License veröffentlicht. Die MIT-Lizenz gilt nicht für die Originaldateien der öffentlichen Daten, die erzeugte SQLite-Datenbank und die abgeleiteten Prüfmaterialien in data/reference/; für diese gelten die Nutzungsbedingungen der jeweiligen Anbieter. Ausführliche Informationen zu Quellenangaben und Weiterverbreitungsrichtlinien finden Sie in DATA_LICENSES.md.