PostGIS MCP 서버

English | Türkçe

PostGIS MCP 서버

이 프로젝트는 Model Context Protocol(MCP)을 사용하여 PostGIS 데이터베이스 연결을 제공하는 서버 애플리케이션입니다.

🚀 기능

• TypeScript로 개발됨

• Model Context Protocol(MCP) 통합

• PostGIS 데이터베이스 지원

• 개발 및 운영 환경을 위한 구성

• 핫 리로드(Hot-reload) 지원

Related MCP server: GeoServer MCP Server

📋 요구 사항

• Node.js (v14 이상)

• PostgreSQL (PostGIS 확장 포함)

• npm 또는 yarn

🛠️ 설치

1. 프로젝트 복제:

git clone https://github.com/receptopalak/postgis-mcp.git
cd postgis-mcp

2. 의존성 설치:

npm install

3. .env 파일 생성:

NODE_ENV=development
DB_URL_1=postgres://user:password@host:5432/database_one
DB_URL_2=postgres://user:password@host:5432/database_two
DB_URL_3=postgres://user:password@host:5432/database_three

기존의 단일 데이터베이스용 DB_HOST / DB_NAME / DB_USER / DB_PASSWORD 변수도 대체(fallback) 방식으로 지원됩니다.

4. 선택 사항: 자연어 테이블 선택 기능을 향상시키려면 domain-aliases.json에서 테이블/도메인 별칭을 사용자 정의하세요.

🚀 사용법

개발 모드

npm run dev

운영 모드

npm run build
npm start

🔧 MCP 구성

MCP 서버에 대해 다음 예시 구성을 사용할 수 있습니다:

{
  "mcpServers": {
    "postgis": {
      "command": "npx",
      "args": ["tsx", "server.ts"],
      "env": {
        "NODE_ENV": "development",
        "DB_URL_1": "postgres://user:pass@host:5432/db_one",
        "DB_URL_2": "postgres://user:pass@host:5432/db_two"
      }
    }
  }
}

📦 의존성

• @modelcontextprotocol/sdk: ^1.12.1

• dotenv: ^16.5.0

• pg: ^8.16.0

• zod: ^3.25.64

🤝 기여 방법

1. 이 저장소를 포크(Fork)하세요

2. 기능 브랜치를 생성하세요 (git checkout -b feature/amazing-feature)

3. 변경 사항을 커밋하세요 (git commit -m 'feat: Add some amazing feature')

4. 브랜치에 푸시하세요 (git push origin feature/amazing-feature)

5. Pull Request를 여세요

📝 라이선스

이 프로젝트는 ISC 라이선스 하에 있습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📧 연락처

프로젝트 소유자 - @receptopalak

프로젝트 링크: https://github.com/receptopalak/postgis-mcp

PostGIS MCP 서버

이 프로젝트는 Model Context Protocol(MCP)을 사용하여 PostGIS 데이터베이스 연결을 제공하는 서버 애플리케이션입니다.

🚀 특징

• TypeScript로 개발됨

• Model Context Protocol(MCP) 통합

• PostGIS 데이터베이스 지원

• 개발 및 운영 환경을 위한 구성

• 핫 리로드(Hot-reload) 지원

📋 요구 사항

• Node.js (v14 이상)

• PostgreSQL (PostGIS 확장 포함)

• npm 또는 yarn

🛠️ 설치

1. 프로젝트 복제:

git clone https://github.com/receptopalak/postgis-mcp.git
cd postgis-mcp

2. 의존성 설치:

npm install

3. .env 파일 생성:

NODE_ENV=development
DB_URL_1=postgres://user:password@host:5432/database_one
DB_URL_2=postgres://user:password@host:5432/database_two
DB_URL_3=postgres://user:password@host:5432/database_three

기존의 단일 데이터베이스용 DB_HOST / DB_NAME / DB_USER / DB_PASSWORD 변수도 대체(fallback) 방식으로 지원됩니다.

4. 선택 사항: 자연어 테이블 선택 기능을 향상시키려면 domain-aliases.json 파일을 사용자 정의하세요.

🚀 사용법

개발 모드

npm run dev

운영 모드

npm run build
npm start

🔧 MCP 구성

MCP 서버 구성에 대해 다음 예시 구성을 사용할 수 있습니다:

{
  "mcpServers": {
    "postgis": {
      "command": "npx",
      "args": ["tsx", "server.ts"],
      "env": {
        "NODE_ENV": "development",
        "DB_URL_1": "postgres://user:pass@host:5432/db_one",
        "DB_URL_2": "postgres://user:pass@host:5432/db_two"
      }
    }
  }
}

📦 의존성

• @modelcontextprotocol/sdk: ^1.12.1

• dotenv: ^16.5.0

• pg: ^8.16.0

• zod: ^3.25.64

🤝 기여 방법

1. 이 저장소를 포크(Fork)하세요

2. 새로운 기능 브랜치를 생성하세요 (git checkout -b feature/amazing-feature)

3. 변경 사항을 커밋하세요 (git commit -m 'feat: Add some amazing feature')

4. 브랜치에 푸시하세요 (git push origin feature/amazing-feature)

5. Pull Request를 생성하세요

📝 라이선스

이 프로젝트는 ISC 라이선스 하에 있습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📧 연락처

프로젝트 소유자 - @receptopalak

프로젝트 링크: https://github.com/receptopalak/postgis-mcp