한국어 |

PostGIS MCP 서버

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

♨ 특징

• TypeScript 개발
• 모형 Context 의정서 (MCP) 통합
• PostGIS 데이터베이스 지원
• 개발 및 생산 환경 설정
• 핫로드 지원

요구사항

• Node.js (v14 이상)
• PostgreSQL (PostGIS 확장)
• npm 또는 원사

672️ 설치

1. Clone 프로젝트:

2. 의존성 설치:

3. .env파일 만들기:

Legacy Single-database DB_HOST / DB_NAME] / DB_USER] / DB_PASSWORD] 변수는 여전히 fallback으로 지원됩니다.

4. 선택: 자연적인 언어 테이블 선택을 개량하기 위하여 domain-aliases.json에 있는 테이블/domain 별명을 주문을 받아서 만드십시오.

♨ 사용

개발 모드

생산 형태

P 구성

MCP 서버의 다음 예제 구성을 사용할 수 있습니다.

☸ 종점

• @modelcontextprotocol/sdk: ^1.12.1
• dotenv: ^16.5.0
• pg : ^8.16.0
• 조드: ^3.25.64

# # # 기여

1. 포크 이 저장소
2. 기능 지점 만들기 (git checkout -b feature/amazing-feature)
3. 명세.

PostGIS MCP Server

English | Türkçe

PostGIS MCP Server

This project is a server application that provides PostGIS database connection using Model Context Protocol (MCP).

🚀 Features

• Developed with TypeScript
• Model Context Protocol (MCP) integration
• PostGIS database support
• Configuration for development and production environments
• Hot-reload support

📋 Requirements

• Node.js (v14 or higher)
• PostgreSQL (with PostGIS extension)
• npm or yarn

🛠️ Installation

1. Clone the project:

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

2. Install dependencies:

npm install

3. Create .env file:

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

Legacy single-database DB_HOST / DB_NAME / DB_USER / DB_PASSWORD variables are still supported as a fallback.

4. Optional: customize table/domain aliases in domain-aliases.json to improve natural-language table selection.

🚀 Usage

Development Mode

npm run dev

Production Mode

npm run build
npm start

🔧 MCP Configuration

You can use the following example configuration for MCP server:

{
  "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"
      }
    }
  }
}

📦 Dependencies

• @modelcontextprotocol/sdk: ^1.12.1
• dotenv: ^16.5.0
• pg: ^8.16.0
• zod: ^3.25.64

🤝 Contributing

1. Fork this repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the ISC License. See the LICENSE file for more information.

📧 Contact

Project Owner - @receptopalak

Project Link: https://github.com/receptopalak/postgis-mcp

---

PostGIS MCP Server

Bu proje, Model Context Protocol (MCP) kullanarak PostGIS veritabanı bağlantısını sağlayan bir sunucu uygulamasıdır.

🚀 Özellikler

• TypeScript ile geliştirilmiş
• Model Context Protocol (MCP) entegrasyonu
• PostGIS veritabanı desteği
• Geliştirme ve üretim ortamları için yapılandırma
• Hot-reload desteği

📋 Gereksinimler

• Node.js (v14 veya üzeri)
• PostgreSQL (PostGIS eklentisi ile)
• npm veya yarn

🛠️ Kurulum

1. Projeyi klonlayın:

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

2. Bağımlılıkları yükleyin:

npm install