AI 연결 (MCP Apps) 베타

쓸 웹 지도 라이브러리와 목적을 말하면 → 파일을 올리고 → 서버가 맞는 변환을 추천하고 → 확인·변경한 조건으로 변환해 → 그 라이브러리에 바로 쓸 결과 파일·주소·적용 코드를 받습니다. 변환 도구 이름을 몰라도 됩니다.

MCP Apps 연동은 베타 기능입니다. 대화 안 화면과 파일 내려받기 지원은 호스트에 따라 달라집니다. 연결이 원활하지 않으면 웹 업로드를 이용하세요. 웹 업로드도 같은 추천 규칙을 씁니다.

연결 주소 https://geospatial.kro.kr/mcp

연결과 사용

  1. MCP Apps와 Streamable HTTP를 지원하는 호스트의 사용자 지정 MCP 서버·커넥터 추가 화면을 엽니다. 이름은 geo-web-bridge, 서버 URL은 위 연결 주소, 인증 방식은 인증 없음으로 등록합니다.
  2. 새 대화에서 geo-web-bridge를 켜고 원하는 결과를 말합니다. 예: “이 SHP를 MapLibre에서 대용량으로 쓰게 변환해 줘”. 모델이 대상 라이브러리·목적·결과 형식·제공 방식을 읽어 넘기면, 그 조건이 미리 선택된 업로드 화면이 열립니다.
  3. 화면에 파일을 올리면 추천 카드가 나옵니다: 변환 방식 → 대상 라이브러리용 주력 결과물 → 추천 이유 → 주의사항(손실·배치 제약). 라이브러리·목적을 바꾸면 다시 계산되고, 다른 방식 보기에서 직접 고를 수도 있습니다. 화면에서 바꾼 조건이 그대로 변환에 쓰입니다.
  4. 변환이 끝나면 주력 결과물·내려받기·리소스 URL·적용 코드·호스팅 조건·결과 파일 검사와 결과 지도를 확인합니다. 결과 지도의 선택 버튼을 켜고 누르면 피처 속성, 모델·타일셋, 래스터·지형 레이어 정보가 보입니다.

채팅 첨부 파일을 서버가 자동으로 읽지는 않습니다. 화면 리소스는 ui://geo/app.html입니다.

요청 예시

추천은 별도 AI 모델이 아니라 서버의 명시 규칙(뷰어별 지원 결과, 목적, 파일 크기·피처 수·좌표계 등)으로 계산합니다. 지원하지 않는 조합은 이유와 실제 가능한 대안을 줍니다.

  • “이 SHP를 MapLibre에서 대용량으로 쓰게”viewer=maplibre · priority=large_datatippecanoe → PMTiles (대안: GDAL → MVT)
  • “CesiumJS에서 쓸 수 있게 (SHP)”viewer=cesiumGDAL → GeoJSON. CesiumJS는 벡터타일 미지원
  • “PMTiles로만 만들어 줘”outputKind=pmtiles라이브러리를 묻지 않고 tippecanoe → PMTiles
  • “이 LAS를 OpenLayers에서”viewer=ol미지원 이유(2D 지도)와 대안: Deck.gl·CesiumJS → 3D Tiles
  • “원본 정밀도를 최대한 살려서 (LAZ, CesiumJS)”viewer=cesium · priority=fidelitypy3dtiles → 3D Tiles (좌표 양자화 없음)
  • “WMS 응답을 시험해 보고 싶어”delivery=service허용 서버: GeoServer 48시간 임시 서비스. 공개 서버: 미지원 이유와 파일 대안

결과 제공 방식

파일 기본

실제 웹 프로젝트에서 사용할 수 있는 공간데이터 파일을 만듭니다. 내려받아 자신의 웹 서버나 애플리케이션에서 씁니다.

  • 여러 파일 결과(타일 폴더·3D Tiles·지형)는 폴더 구조 그대로 zip. 결과 안에 이 서버 주소 의존이 없는지 서버가 검사
  • 좌표계·범위·레이어 이름, 형식별 호스팅 조건(MIME·Range 요청·CORS), 대상 라이브러리 적용 코드 제공
  • 내려받은 파일은 이 서버와 무관하게 계속 사용. 서버의 사본과 내려받기 주소는 운영자가 정리할 때까지 보관(기간 보장 없음)

서비스 48시간 임시

WMS·WFS·OGC API Features·벡터타일 등 공간 서비스의 실제 응답과 웹 지도 연동을 확인하는 용도입니다.

  • 발행 완료 후 48시간이 지나면 자동 만료(이후 410). 연장·자동 갱신 없음
  • 만료되면 이 작업의 DB 표·레이어를 정리. 계속 쓰려면 파일로 변환해 직접 호스팅
  • 공개 배포에서는 제공하지 않습니다. 요청하면 파일로 바꾸지 않고 이유와 파일 대안을 안내

터미널 클라이언트 · 앱 화면 없이 쓰기

Claude Code

claude mcp add --transport http geo-web-bridge https://geospatial.kro.kr/mcp

/mcp에서 연결 확인.

Codex CLI

codex mcp add geo-web-bridge --url https://geospatial.kro.kr/mcp

codex mcp list에서 연결 확인.

MCP Apps 화면을 지원하지 않는 클라이언트도 geo_identify → geo_recommend → geo_convert → geo_status로 같은 추천·결과·만료 정보를 텍스트로 받습니다. 파일은 웹 업로드로 올리고, 만든 작업 id를 stage로 넘기면 같은 파일을 다른 조건으로 다시 변환할 수 있습니다.

제공하는 도구

  • geo_identify업로드 화면을 엽니다. 대상 라이브러리·목적을 넘기면 화면에 미리 선택됩니다. stage를 주면 맡긴 파일의 형식을 확인하고 추천합니다.
  • geo_recommend대상 라이브러리·목적·결과 형식·제공 방식에 맞는 변환 방식과 이유·주의를 추천합니다. 변환은 시작하지 않습니다.
  • geo_convert추천(방식 생략) 또는 직접 고른 방식으로 작업을 시작합니다. 서버가 조건을 다시 확인하고 맞지 않으면 시작하지 않습니다.
  • geo_status처리 단계·오류, 완료된 주력 결과물·내려받기·리소스 URL·적용 코드·결과 파일 검사, 서비스 만료 시각을 확인합니다.
  • geo_formats받는 확장자, 파일 변환 방식, 뷰어별 지원을 확인합니다.

geo_stage_chunk는 MCP Apps 화면이 파일을 나눠 보내는 내부 도구입니다.

현재 공개 배포에서 가능한 범위

  • 파일은 최대 200MB, 업로드는 접속자별 하루 1GiB, 변환은 한 번에 하나입니다. 저장 공간이 부족하거나 다른 작업이 진행 중이면 새 요청을 거절합니다.
  • 파일 결과를 만드는 경로만 제공합니다. 서버 로컬 파일 경로·외부 URL 가져오기·새 공간 서비스 발행은 제공하지 않습니다.
  • 서버의 원본·결과는 운영자가 정리할 때까지 보관하며 기간은 보장하지 않습니다. 결과 링크를 아는 사용자가 열 수 있습니다.
  • 준비된 26개 예시와 기존 공간 서버 데이터는 계속 조회할 수 있습니다.
  • Cesium for Unreal 실시간 화면은 비활성화 상태입니다. 웹 CesiumJS 뷰어는 사용할 수 있습니다.
  • 국내 주소·코드 연계 도구는 개발 중이며 이 공개 MCP 연결의 도구로 제공하지 않습니다.

검증 범위

  • 공식 SDK 브리지 시험: AI가 넘긴 라이브러리로 화면이 열리고, 사용자가 바꾼 라이브러리가 추천·변환 인자·결과에 반영됨. 변환·결과 지도·내려받기까지 확인했습니다.
  • 시험 파일 33종(25개 형식과 좌표계·인코딩·폴더 구조 경계 사례)을 추천 방식으로 변환하고 결과 파일 검사·결과 지도 표시를 확인했습니다.
  • 서비스 48시간 만료는 서비스를 허용한 로컬 시험 서버에서 만료 전 응답 → 만료 뒤 차단 → 정리까지 확인했습니다.
  • 실제 Claude·ChatGPT 계정에서의 연결과 호스트별 앱 표시·도구 승인·내려받기는 아직 확인하지 않았습니다.