PostGIS MCPサーバー

English | Türkçe

PostGIS MCPサーバー

このプロジェクトは、Model Context Protocol (MCP) を使用してPostGISデータベース接続を提供するサーバーアプリケーションです。

🚀 特徴

• TypeScriptで開発

• Model Context Protocol (MCP) 統合

• PostGISデータベースサポート

• 開発および本番環境向けの構成

• ホットリロードサポート

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 変数もフォールバックとして引き続きサポートされています。

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. このリポジトリをフォークします

2. フィーチャーブランチを作成します (git checkout -b feature/amazing-feature)

3. 変更をコミットします (git commit -m 'feat: Add some amazing feature')

4. ブランチにプッシュします (git push origin feature/amazing-feature)

5. プルリクエストを作成します

📝 ライセンス

このプロジェクトはISCライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

📧 連絡先

プロジェクトオーナー - @receptopalak

プロジェクトリンク: https://github.com/receptopalak/postgis-mcp

PostGIS MCPサーバー

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