지오서버 MCP 서버

버전 0.4.0(알파)은 현재 개발 중이며 곧 출시될 예정입니다. 여러분의 기여를 환영하며, 이 프로젝트 구축에 함께해 주실 개발자분들을 환영합니다.

🎥 데모

📋 목차

🚀 특징

🔍 GeoServer 작업 공간, 레이어 및 스타일 쿼리 및 조작
🗺️ 벡터 데이터에 대한 공간 쿼리 실행
🎨 지도 시각화 생성
🌐 OGC 호환 웹 서비스(WMS, WFS)에 접속하세요
🛠️ MCP 호환 클라이언트와의 간편한 통합

📋 필수 조건

Python 3.10 이상
REST API가 활성화된 GeoServer 인스턴스 실행
MCP 호환 클라이언트(Claude Desktop 또는 Cursor 등)
패키지 설치를 위한 인터넷 연결

🛠️ 설치

귀하의 요구 사항에 가장 적합한 설치 방법을 선택하세요.

🛠️ 설치(Docker)

Docker 설치는 GeoServer MCP 서버를 실행하는 가장 빠르고 독립적인 방법입니다. 다음과 같은 경우에 적합합니다.

빠른 테스트 및 평가
프로덕션 배포
Python 종속성을 피하고 싶은 환경
다양한 시스템에 걸친 일관된 배포

geoserver-mcp를 실행합니다.

지엑스피1

클라이언트 구성:

Claude Desktop을 사용하는 경우 claude_desktop_config.json 편집합니다. Cursor를 사용하는 경우 .cursor/mcp.json 을 만듭니다.

{
  "mcpServers": {
    "geoserver-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GEOSERVER_URL=http://localhost:8080/geoserver",
        "-e",
        "GEOSERVER_USER=admin",
        "-e",
        "GEOSERVER_PASSWORD=geoserver",
        "-p",
        "8080:8080",
        "mahdin75/geoserver-mcp"
      ]
    }
  }
}

🛠️ 설치(pip)

pip 설치는 서버를 시스템에서 직접 실행하려는 대부분의 사용자에게 권장됩니다. 이 방법은 다음과 같은 경우에 가장 적합합니다.

서버를 로컬로 실행하려는 일반 사용자
Python 3.10 이상이 설치된 시스템
서버 구성을 사용자 정의하려는 사용자
개발 및 테스트 목적

uv 패키지 관리자를 설치합니다.

pip install uv

가상 환경 만들기(Python 3.10+):

리눅스/맥:

uv venv --python=3.10

윈도우 PowerShell:

uv venv --python=3.10

pip를 사용하여 패키지를 설치하세요:

uv pip install geoserver-mcp

GeoServer 연결 구성:

리눅스/맥:

export GEOSERVER_URL="http://localhost:8080/geoserver"
export GEOSERVER_USER="admin"
export GEOSERVER_PASSWORD="geoserver"

윈도우 PowerShell:

$env:GEOSERVER_URL="http://localhost:8080/geoserver"
$env:GEOSERVER_USER="admin"
$env:GEOSERVER_PASSWORD="geoserver"

서버를 시작합니다:

Claude 데스크톱을 사용하려는 경우 이 단계는 필요하지 않습니다. 커서나 사용자 지정 클라이언트를 사용하는 경우 다음 코드를 실행하세요.

리눅스:

source .venv/bin/activate

geoserver-mcp

또는

source .venv/bin/activate

geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

윈도우 PowerShell:

.\.venv\Scripts\activate
geoserver-mcp

또는

.\.venv\Scripts\activate
geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

클라이언트 구성:

Claude Desktop을 사용하는 경우 claude_desktop_config.json 편집합니다. Cursor를 사용하는 경우 .cursor/mcp.json 을 만듭니다.

윈도우:

{
  "mcpServers": {
    "geoserver-mcp": {
      "command": "C:\\path\\to\\geoserver-mcp\\.venv\\Scripts\\geoserver-mcp",
      "args": [
        "--url",
        "http://localhost:8080/geoserver",
        "--user",
        "admin",
        "--password",
        "geoserver"
      ]
    }
  }
}

리눅스:

{
  "mcpServers": {
    "geoserver-mcp": {
      "command": "/path/to/geoserver-mcp/.venv/bin/geoserver-mcp",
      "args": [
        "--url",
        "http://localhost:8080/geoserver",
        "--user",
        "admin",
        "--password",
        "geoserver"
      ]
    }
  }
}

🛠️ 개발 설치

개발 설치는 코드베이스를 수정하려는 기여자와 개발자를 위해 설계되었습니다. 이 방법은 다음과 같은 경우에 적합합니다.

프로젝트에 기여하는 개발자
소스 코드를 수정해야 하는 사용자
새로운 기능 테스트
디버깅 및 개발 목적

uv 패키지 관리자를 설치합니다.

pip install uv

가상 환경 만들기(Python 3.10+):

uv venv --python=3.10

pip를 사용하여 패키지를 설치하세요:

uv pip install -e .

GeoServer 연결 구성:

리눅스/맥:

export GEOSERVER_URL="http://localhost:8080/geoserver"
export GEOSERVER_USER="admin"
export GEOSERVER_PASSWORD="geoserver"

윈도우 PowerShell:

$env:GEOSERVER_URL="http://localhost:8080/geoserver"
$env:GEOSERVER_USER="admin"
$env:GEOSERVER_PASSWORD="geoserver"

서버를 시작합니다:

Claude 데스크톱을 사용하려는 경우 이 단계는 필요하지 않습니다. 커서나 사용자 지정 클라이언트를 사용하는 경우 다음 코드를 실행하세요.

리눅스:

source .venv/bin/activate

geoserver-mcp

또는

source .venv/bin/activate

geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

윈도우 PowerShell:

.\.venv\Scripts\activate
geoserver-mcp

또는

.\.venv\Scripts\activate
geoserver-mcp --url http://localhost:8080/geoserver --user admin --password geoserver --debug

클라이언트 구성:

Claude Desktop을 사용하는 경우 claude_desktop_config.json 편집합니다. Cursor를 사용하는 경우 .cursor/mcp.json 을 만듭니다.

윈도우:

{
  "mcpServers": {
    "geoserver-mcp": {
      "command": "C:\\path\\to\\geoserver-mcp\\.venv\\Scripts\\geoserver-mcp",
      "args": [
        "--url",
        "http://localhost:8080/geoserver",
        "--user",
        "admin",
        "--password",
        "geoserver"
      ]
    }
  }
}

리눅스:

{
  "mcpServers": {
    "geoserver-mcp": {
      "command": "/path/to/geoserver-mcp/.venv/bin/geoserver-mcp",
      "args": [
        "--url",
        "http://localhost:8080/geoserver",
        "--user",
        "admin",
        "--password",
        "geoserver"
      ]
    }
  }
}

🛠️ 사용 가능한 도구

🛠️ 작업 공간 및 레이어 관리

도구	설명
`list_workspaces`	사용 가능한 작업 공간 가져오기
`create_workspace`	새 작업 공간 만들기
`get_layer_info`	자세한 레이어 메타데이터 가져오기
`list_layers`	작업 공간에 레이어 나열
`create_layer`	새 레이어를 만듭니다
`delete_resource`	리소스 제거

🛠️ 데이터 운영

도구	설명
`query_features`	벡터 데이터에 CQL 쿼리 실행
`update_features`	기능 속성 수정
`delete_features`	기준에 따라 기능 제거

🛠️ 시각화

도구	설명
`generate_map`	스타일이 적용된 지도 이미지 만들기
`create_style`	새로운 SLD 스타일 정의
`apply_style`	레이어에 기존 스타일 적용

🛠️ 클라이언트 개발

GeoServer MCP 서버와 상호 작용하는 자체 클라이언트를 개발할 계획이라면 examples/client.py 에 있는 예제 클라이언트 구현에서 영감을 얻을 수 있습니다. 이 예제는 다음을 보여줍니다.

MCP 서버와 연결을 설정하는 방법
요청을 보내고 응답을 처리하는 방법
기본 오류 처리 및 연결 관리
다양한 도구 및 작업의 사용 예

이 예제 클라이언트는 프로토콜을 이해하고 사용자 고유의 클라이언트 애플리케이션을 구현하는 데 좋은 시작점이 될 것입니다.

또한, 다음은 사용 예입니다.

작업 공간 나열

Tool: list_workspaces
Parameters: {}
Response: ["default", "demo", "topp", "tiger", "sf"]

레이어 정보 가져오기

Tool: get_layer_info
Parameters: {
"workspace": "topp",
"layer": "states"
}

쿼리 기능

Tool: query_features
Parameters: {
"workspace": "topp",
"layer": "states",
"filter": "PERSONS > 10000000",
"properties": ["STATE_NAME", "PERSONS"]
}

지도 생성

Tool: generate_map
Parameters: {
"layers": ["topp:states"],
"styles": ["population"],
"bbox": [-124.73, 24.96, -66.97, 49.37],
"width": 800,
"height": 600,
"format": "png"
}

🔮 계획된 기능

[ ] 커버리지 및 래스터 데이터 관리
[ ] 보안 및 접근 제어
[ ] 고급 스타일링 기능
[ ] WPS 처리 작업
[ ] GeoWebCache 통합

🤝 기여하기

여러분의 참여를 환영합니다! 다음과 같은 방법으로 도움을 주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/AmazingFeature )
변경 사항을 커밋합니다( git commit -m 'Add some AmazingFeature' )
브랜치에 푸시( git push origin feature/AmazingFeature )
풀 리퀘스트 열기

PR 설명에 문제와 해결책을 명확하게 설명해 주세요. 해당되는 경우 관련 이슈 번호를 포함하세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🔗 관련 프로젝트

모델 컨텍스트 프로토콜 - 핵심 MCP 구현
GeoServer REST API - 공식 GeoServer REST 문서
GeoServer REST Python 클라이언트 - GeoServer REST API용 Python 클라이언트

📞 지원

지원을 받으려면 문제를 열어주세요.

🏆 배지

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

대규모 언어 모델을 GeoServer REST API에 연결하는 모델 컨텍스트 프로토콜 서버로, AI 도우미가 자연어를 통해 지리 공간 데이터를 쿼리하고 조작할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

OpenAPI MCP Server
ivo-toby
-
security
A
license
-
quality
A server that enables Large Language Models to discover and interact with REST APIs defined by OpenAPI specifications through the Model Context Protocol.
Last updated -
1,641
136
TypeScript
MIT License
MCP Google Map Server
cablate
A
security
A
license
A
quality
A Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.
Last updated -
7
983
63
TypeScript
MIT License
Superset MCP Server
LiusCraft
A
security
F
license
A
quality
A Model Context Protocol server that enables large language models to interact with Apache Superset databases through REST API, supporting database queries, table lookups, field information retrieval, and SQL execution.
Last updated -
4
4
TypeScript
MCP Server For Local
Dreamboat-Rachel
A
security
A
license
A
quality
A customizable Model Context Protocol server implementation that enables AI models to interact with external tools including weather queries, Google search, and camera control functionality.
Last updated -
1
13
Python
Apache 2.0

View all related MCP servers

Appeared in Searches

A search for Geographic Information Systems (GIS)

GeoServer MCP Server