Gyeongbuk MCP

Es un servidor FastMCP que proporciona datos regionales y públicos de Gyeongbuk a agentes de IA.

Actualmente ofrece hospitales, paradas de autobús, mercados tradicionales, proporción de población por edad, niveles de seguridad regional y una herramienta de recomendación de zonas de vida centradas en mercados para personas mayores sin coche. El modo de ejecución predeterminado convierte los archivos de datos públicos originales a SQLite para su consulta, por lo que no se necesitan claves de autenticación de API ni conexión a servidores externos. Consulte docs/ para conocer las entradas y salidas de cada herramienta y las limitaciones de los datos.

Inicio rápido

Se requiere Python 3.12 o superior y uv.

make sync
make data-setup
make run

make data-setup descarga las fuentes oficiales fijadas en data/sources.toml, verifica su SHA-256 y formato de archivo, y luego crea una base de datos SQLite local. No se necesita clave de autenticación de API. Las fuentes y la base de datos generada no se incluyen en Git ni en las releases de GitHub.

La instantánea generada a partir de las fuentes descargadas actualmente contiene 3.415 hospitales y clínicas de Gyeongbuk, 16.031 registros de especialidades médicas, 29.735 paradas de autobús de Gyeongbuk, 53 rutas de Pohang y 196 patrones de ruta, 51 rutas de Pohang donde es posible determinar el despacho, 132 mercados tradicionales, 3.949 registros de rangos de edad y 138 niveles de seguridad regional.

Si es necesario, copie la configuración de ejemplo. En el modo de archivo no se necesita clave de autenticación.

cp .env.example .env

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

Configure DATA_MODE=api y DATA_GO_KR_SERVICE_KEY solo cuando use temporalmente el modo API. El modo API se aplica únicamente a las consultas de hospitales, paradas de autobús y mercados; las herramientas de población y seguridad siguen usando la base de datos SQLite local. .env está excluido de Git, y las variables de entorno del shell o CI con el mismo nombre tienen prioridad sobre .env.

Related MCP server: power-plan-db

Registro del cliente MCP

Regístrelo en la configuración de MCP stdio de la siguiente manera. Reemplace /absolute/path/gyeongbuk-mcp por la ruta absoluta real del repositorio.

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

Comandos

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 훅 실행

Cada comando también se puede ejecutar directamente con uv run ....

Consulte CONTRIBUTING.md para participar en el desarrollo y SECURITY.md para notificar vulnerabilidades.

Estructura

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

Licencia

El código fuente se distribuye bajo la MIT License. La MIT no se aplica a los datos públicos originales, a la base de datos SQLite generada ni a los materiales de verificación derivados en data/reference/, que se rigen por las condiciones de uso de cada organismo proveedor. Consulte DATA_LICENSES.md para obtener más detalles sobre la atribución de fuentes y la política de redistribución.