PostGIS MCP-Server

English | Türkçe

PostGIS MCP-Server

Dieses Projekt ist eine Serveranwendung, die eine PostGIS-Datenbankverbindung über das Model Context Protocol (MCP) bereitstellt.

🚀 Funktionen

• Mit TypeScript entwickelt

• Integration des Model Context Protocol (MCP)

• Unterstützung für PostGIS-Datenbanken

• Konfiguration für Entwicklungs- und Produktionsumgebungen

• Unterstützung für Hot-Reload

Related MCP server: GeoServer MCP Server

📋 Anforderungen

• Node.js (v14 oder höher)

• PostgreSQL (mit PostGIS-Erweiterung)

• npm oder yarn

🛠️ Installation

1. Klonen Sie das Projekt:

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

2. Installieren Sie die Abhängigkeiten:

npm install

3. Erstellen Sie eine .env-Datei:

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

Die alten Single-Database-Variablen DB_HOST / DB_NAME / DB_USER / DB_PASSWORD werden weiterhin als Fallback unterstützt.

4. Optional: Passen Sie Tabellen-/Domain-Aliase in domain-aliases.json an, um die Auswahl von Tabellen in natürlicher Sprache zu verbessern.

🚀 Verwendung

Entwicklungsmodus

npm run dev

Produktionsmodus

npm run build
npm start

🔧 MCP-Konfiguration

Sie können die folgende Beispielkonfiguration für den MCP-Server verwenden:

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

📦 Abhängigkeiten

• @modelcontextprotocol/sdk: ^1.12.1

• dotenv: ^16.5.0

• pg: ^8.16.0

• zod: ^3.25.64

🤝 Mitwirken

1. Forken Sie dieses Repository

2. Erstellen Sie Ihren Feature-Branch (git checkout -b feature/amazing-feature)

3. Committen Sie Ihre Änderungen (git commit -m 'feat: Add some amazing feature')

4. Pushen Sie in den Branch (git push origin feature/amazing-feature)

5. Öffnen Sie einen Pull Request

📝 Lizenz

Dieses Projekt ist unter der ISC-Lizenz lizenziert. Weitere Informationen finden Sie in der Datei LICENSE.

📧 Kontakt

Projektinhaber - @receptopalak

Projektlink: 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

3. .env dosyası oluşturun:

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

Eski tek veritabanlı DB_HOST / DB_NAME / DB_USER / DB_PASSWORD değişkenleri de fallback olarak desteklenir.

4. Opsiyonel: doğal dilde tablo seçimini iyileştirmek için domain-aliases.json dosyasını özelleştirin.

🚀 Kullanım

Geliştirme Modu

npm run dev

Üretim Modu

npm run build
npm start

🔧 MCP Yapılandırması

MCP sunucu yapılandırması için aşağıdaki örnek yapılandırmayı kullanabilirsiniz:

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

📦 Bağımlılıklar

• @modelcontextprotocol/sdk: ^1.12.1

• dotenv: ^16.5.0

• pg: ^8.16.0

• zod: ^3.25.64

🤝 Katkıda Bulunma

1. Bu depoyu fork edin

2. Yeni bir özellik dalı oluşturun (git checkout -b feature/amazing-feature)

3. Değişikliklerinizi commit edin (git commit -m 'feat: Add some amazing feature')

4. Dalınıza push edin (git push origin feature/amazing-feature)

5. Bir Pull Request oluşturun

📝 Lisans

Bu proje ISC lisansı altında lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakın.

📧 İletişim

Proje Sahibi - @receptopalak

Proje Linki: https://github.com/receptopalak/postgis-mcp