PostGIS MCP 服务器

English | Türkçe

PostGIS MCP 服务器

本项目是一个使用模型上下文协议 (MCP) 提供 PostGIS 数据库连接的服务器应用程序。

🚀 特性

• 使用 TypeScript 开发

• 模型上下文协议 (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. 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 服务器

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