Cesium MCP MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

12개 도구 세트에 걸쳐 58개 도구
카메라 및 관측점 제어(빠른 이동, 관찰, 저장된 뷰)
Entity CRUD — 마커, 라벨, 3D 모델, 다각형, 폴리라인
레이어 — GeoJSON, 이미지 베이스맵, 가시성
고급 — 3D 타일, 지형, 애니메이션, 궤적, 히트맵, 위치정보
상호 작용 — 스크린샷, 강조 표시, 측정

라이브 데모

실제 사용 모습

cesium-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cesium-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ],
      "env": {
        "CESIUM_TOOLSETS": "all"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "cesium-mcp",
      "command": "npx",
      "args": [
        "-y",
        "cesium-mcp-runtime"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "cesium-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "cesium-mcp-runtime"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add cesium-mcp -- npx -y cesium-mcp-runtime

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Cesium MCP

실시간 지구본에서 위치 브리핑 비행

👤 운영, 물류, 기획팀 ⏱ ~15 min intermediate

언제 쓸까: 정적인 슬라이드 대신 실시간 3D 브리핑을 원합니다.

사전 조건

실행 중인 CesiumJS 뷰어 앱 — 앱에 세슘을 삽입하세요. 커넥터를 노출시키다
세슘 이온 액세스 토큰(이온 자산을 사용하는 경우) — https://ion.cesium.com/tokens

흐름

사이트로 날아가세요

에펠탑으로 날아가서 '사이트 A'라는 라벨이 붙은 빨간색 마커를 놓습니다.✓ 복사됨

→ 카메라가 움직입니다. 마커가 라벨과 함께 나타납니다.
오버레이 데이터

이 이웃 경계의 GeoJSON을 반투명 레이어로 로드합니다.✓ 복사됨

→ 레이어 표시 및 대화형
포착

슬라이드에 붙여넣을 수 있는 스크린샷을 찍으세요.✓ 복사됨

→ PNG가 반환됨

결과: 고정된 이미지 대신 연결 가능한 실시간 브리핑 보기입니다.

함정

단순화 없이 거대한 GeoJSON 로드 — 합리적인 정점 수로 단순화합니다. 세슘은 백만 개의 꼭지점 다각형을 질식시킬 수 있습니다

함께 쓰기: filesystem

시간 경과에 따른 함대의 궤적 애니메이션

👤 운영 및 이동성 팀 ⏱ ~25 min intermediate

언제 쓸까: 타임스탬프가 있는 위치가 있고 지구본에서 재생을 원합니다.

사전 조건

타임코드 위치 데이터 — 타임스탬프가 포함된 CSV 또는 GeoJSON

흐름

시간에 따라 엔터티 로드

Fleet.csv에서 SampledPositionProperty 트랙을 사용하여 3개의 차량 엔터티를 추가합니다.✓ 복사됨

→ 엔터티가 렌더링됩니다. 타임라인은 범위를 보여줍니다.
놀다

10배속 애니메이션, 카메라가 차량 A를 따라갑니다.✓ 복사됨

→ 부드러운 재생; 카메라가 피사체에 고정됨

결과: 세슘 코드를 작성하지 않고도 대화형 차량 재생이 가능합니다.

3D 타일 데이터세트 로드 및 단일 건물 검사

👤 도시 계획, AEC, BIM 팀 ⏱ ~20 min advanced

언제 쓸까: 3D 타일 세트가 있고 기능을 쿼리하려고 합니다.

흐름

타일셋 로드

<URL>에서 3D 타일을 로드하고, 지형 방향을 지정하고, 최대 화면 공간 오류를 16으로 설정하세요.✓ 복사됨

→ 심도 싸움 없이 타일셋 렌더링
강조 표시 + 측정

선택한 엔터티의 건물을 강조 표시합니다. 높이를 측정해 보세요.✓ 복사됨

→ 강조된 건물; 보고된 키

결과: 이해관계자 검토를 위한 빠른 대화형 검사.

함정

지형을 통과하는 카메라 클리핑 — 지형에 대한 깊이 테스트를 활성화합니다. 근거리/원거리 클립 조정

포인트 데이터의 히트맵 오버레이

👤 밀도를 시각화하는 분석가 ⏱ ~15 min intermediate

언제 쓸까: 외부 플로팅 도구 없이 지도에 히트맵이 필요합니다.

흐름

수집 포인트

points.csv(경도, 위도, 체중)를 가져옵니다.✓ 복사됨

→ 히트맵 도구 세트에 로드된 포인트
외관 조정

히트맵 반경 25px, 그래디언트 viridis.✓ 복사됨

→ 스타일이 적용된 오버레이 표시

결과: 지구본에 내장된 방어 가능한 히트맵입니다.

함께 쓰기: mcp-echarts

조합

다른 MCP와 조합해 10배 효율

cesium-mcp + filesystem

로컬 데이터 세트(GeoJSON, CSV)를 로드하고 지구본에서 렌더링

./data/points.csv를 열고 지구본의 히트맵으로 가져옵니다.✓ 복사됨

cesium-mcp + mcp-echarts

3D 지구본과 클래식 통계 차트를 결합하세요

측면의 세슘 밀도 지도 + 전자 차트 히스토그램 — 동기화된 필터.✓ 복사됨

cesium-mcp + fetch

라이브 피드(AIS, ADS-B) 가져오기 및 애니메이션

실시간 선박 위치를 가져오고 30초마다 개체를 업데이트합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
camera.flyTo / lookAt / saveView / loadView	coords / heading / pitch / roll	카메라 탐색	0
entities.add / update / remove	geometry + styling	마커, 라벨, 모델, 폴리곤, 폴리라인	0
layers.add (GeoJSON / imagery) / toggle	source + style	지리공간 레이어 전환 또는 추가	bandwidth for remote sources
tiles3d.load / query	tileset URL	3D 타일 렌더링 및 기능 선택	0
terrain.set	terrain provider	지형 제공자 교체	0
animation.play / trajectory.load	time interval / track	시간 기반 재생	0
interaction.screenshot / highlight / measure	area or picked entity	캡처, 선택 및 측정	0
heatmap.add	points + radius + gradient	밀도 시각화	0
geolocation.goto	name or coords	지정된 장소 내비게이션	0

비용 및 제한

운영 비용

API 쿼터: 서버 자체에는 없습니다. 이온 자산을 사용하는 경우 세슘 이온 토큰에는 자체 할당량이 있습니다.
호출당 토큰: 소규모 작전; 토큰 카운트에 포함되지 않은 3D 타일/이미지 바이트
금액: 무료 — 세슘은 오픈 소스입니다.
팁: 특별히 확장 세트가 필요하지 않은 한 기본 31개 핵심 도구를 사용하세요. 단순한 표면 = 잘못된 방향 전환이 적습니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 사용되는 경우 env var의 세슘 이온 토큰.

데이터 외부 송신: 구성한 이미지/지형 제공자(Ion, MapBox, 사용자 정의 타일 서버)로 가져옵니다.

신뢰할 수 없는 소스의 3D 타일 또는 이미지는 브라우저에서 전체 WebGL 권한으로 실행될 수 있습니다. URL을 스크립트처럼 처리하세요.
스크린샷에는 민감한 오버레이가 포함될 수 있습니다. 공유하기 전에 검토하세요.

문제 해결

자주 발생하는 오류와 해결

카메라가 대상 대신 우주로 점프합니다.

위도/경도 순서(세슘은 lon, lat를 사용함)와 고도 값을 확인하세요.

확인: Log args passed to camera.flyTo

GeoJSON은 평면적으로 보입니다.

지형 샘플링이 꺼져 있습니다. 레이어 옵션에서 clipsToGround를 활성화하세요.

확인: Inspect the layer's styling options

타일셋 검정색/누락

CORS는 많은 타일셋을 차단합니다. 적절한 헤더가 있는 호스트 또는 프록시.

확인: DevTools Network panel for the tileset URL

대안

Cesium MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
google-maps	2D 지도와 Places API로 충분합니다.	3D 지구본 또는 3D 타일 없음
google-map	당신은 이미 Google 지도 인프라를 사용 중입니다.	세슘보다 3D가 덜 풍부함
mcp-echarts	귀하의 데이터는 지리정보가 아닌 통계적 데이터입니다.	지도 컨텍스트 없음

Cesium MCP

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: Cesium MCP

실시간 지구본에서 위치 브리핑 비행

사전 조건

흐름

함정

시간 경과에 따른 함대의 궤적 애니메이션

사전 조건

흐름

3D 타일 데이터세트 로드 및 단일 건물 검사

흐름

함정

포인트 데이터의 히트맵 오버레이

흐름

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

Cesium MCP 다른 것과 비교

더 보기

리소스