JordanGunn/gdal-mcp

AI 에이전트에게 GDAL/Rasterio 작업을 노출하는 MCP 서버로, 방법론이 중요한 작업(CRS 선택, 리샘플링 방법, 쿼리 범위 등)을 실행하기 전에 구조화된 정당화(justification)를 요구하는 리플렉션 미들웨어(reflection middleware)를 포함하고 있습니다.

uvx --from gdal-mcp gdal --transport stdio

docker build -t gdal-mcp .
docker run -i gdal-mcp gdal --transport stdio

git clone https://github.com/Wayfinder-Foundry/gdal-mcp.git
cd gdal-mcp
uv sync
...

claude_desktop_config.json에 추가하십시오.

(macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\, Linux: ~/.config/Claude/):

{
"mcpServers": {
"gdal-mcp": {
...

Claude Desktop을 재시작하십시오. MCP 서버 표시기가 나타나야 하며, raster_* 및 vector_* 도구를 사용할 수 있게 됩니다.

GDAL_MCP_WORKSPACES는 서버가 접근할 수 있도록 허용된 디렉토리의 콜론(:) 구분 목록입니다. 설정되지 않은 경우 모든 경로가 허용되며 경고가 로그에 기록됩니다.

선택적 도구 인터페이스(tool-surface) 플래그: RASTER=true, VECTOR=true. 전체 세트는 docs/ENVIRONMENT_VARIABLES.md를 참조하십시오.

Raster (래스터): raster_info, raster_convert, raster_reproject, raster_stats, raster_query

Vector (벡터): vector_info, vector_convert, vector_reproject, vector_clip, vector_buffer, vector_simplify, vector_query

Resources (리소스): catalog (workspace://...), metadata (metadata://...), reference (reference://...), query results (query://result/{id})

Prompts (프롬프트): justify_crs_selection, justify_resampling_method, justify_query_extent (src/prompts/ 아래에 더 많이 있음)

매개변수, 반환 형태(return shapes) 및 실행 예제는 TOOLS.md를 참조하십시오.

방법론이 중요한 도구들은 호출하는 에이전트가 구조화된 정당화를 생성할 때까지 실행을 거부합니다. 흐름은 다음과 같습니다:

• 에이전트가 예를 들어 raster_reproject(dst_crs="EPSG:3857", resampling="cubic", ...)를 호출합니다.
• 미들웨어가 일치하는 해시가 있는지 .preflight/justifications/{domain}/에서 확인합니다.
• 일치하는 것이 없으면, 호출 시 ToolError가 발생합니다.

관련 프롬프트(예: justify_crs_selection)를 가리키는 힌트와 함께합니다. - 에이전트는 해당 프롬프트를 호출하고, Justification 스키마(의도, 고려된 대안, 선택, 트레이드오프, 신뢰도)를 채운 다음, __reflection 페이로드를 사용하여 도구를 재호출합니다. - 정당화 내용은 도메인별 키로 캐시되므로, EPSG:3857에 대한 CRS 근거는 후속 호출에서 raster_reproject와 vector_reproject 모두를 만족시킵니다.

스키마 및 캐시 레이아웃은 docs/REFLECTION.md를, 이 기능이 존재하는 이유(철학)는 docs/PHILOSOPHY.md를 참조하십시오.

• TOOLS.md — 도구 참고 자료
• docs/ENVIRONMENT_VARIABLES.md — 런타임 설정
• docs/REFLECTION.md — 리플렉션 미들웨어 내부 구조
• docs/PHILOSOPHY.md — 설계 철학 및 방향성
• docs/ROADMAP.md — 릴리스 이력 및 방향성
• CHANGELOG.md — 버전별 변경 로그
• CONTRIBUTING.md — 기여 가이드

** 접근 거부: 허용된 작업 공간 외부 경로** — GDAL_MCP_WORKSPACES를 설정하여 해당 디렉토리를 포함하도록 하십시오(