Servidor MCP de PostGIS

Inglés | Türkçe

Servidor MCP de PostGIS

Este proyecto es una aplicación de servidor que proporciona conexión a bases de datos PostGIS utilizando el Protocolo de Contexto de Modelo (MCP).

🚀 Características

• Desarrollado con TypeScript

• Integración con el Protocolo de Contexto de Modelo (MCP)

• Soporte para bases de datos PostGIS

• Configuración para entornos de desarrollo y producción

• Soporte para recarga en caliente (hot-reload)

Related MCP server: GeoServer MCP Server

📋 Requisitos

• Node.js (v14 o superior)

• PostgreSQL (con la extensión PostGIS)

• npm o yarn

🛠️ Instalación

1. Clona el proyecto:

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

2. Instala las dependencias:

npm install

3. Crea el archivo .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

Las variables heredadas de base de datos única DB_HOST / DB_NAME / DB_USER / DB_PASSWORD siguen siendo compatibles como respaldo.

4. Opcional: personaliza los alias de tablas/dominios en domain-aliases.json para mejorar la selección de tablas mediante lenguaje natural.

🚀 Uso

Modo de desarrollo

npm run dev

Modo de producción

npm run build
npm start

🔧 Configuración de MCP

Puedes usar el siguiente ejemplo de configuración para el servidor 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"
      }
    }
  }
}

📦 Dependencias

• @modelcontextprotocol/sdk: ^1.12.1

• dotenv: ^16.5.0

• pg: ^8.16.0

• zod: ^3.25.64

🤝 Contribución

1. Haz un fork de este repositorio

2. Crea tu rama de características (git checkout -b feature/amazing-feature)

3. Confirma tus cambios (git commit -m 'feat: Add some amazing feature')

4. Sube los cambios a la rama (git push origin feature/amazing-feature)

5. Abre una Pull Request

📝 Licencia

Este proyecto está bajo la Licencia ISC. Consulta el archivo LICENSE para más información.

📧 Contacto

Propietario del proyecto - @receptopalak

Enlace del proyecto: https://github.com/receptopalak/postgis-mcp

Servidor MCP de PostGIS

Este proyecto es una aplicación de servidor que proporciona conexión a bases de datos PostGIS utilizando el Protocolo de Contexto de Modelo (MCP).

🚀 Características

• Desarrollado con TypeScript

• Integración con el Protocolo de Contexto de Modelo (MCP)

• Soporte para bases de datos PostGIS

• Configuración para entornos de desarrollo y producción

• Soporte para recarga en caliente (hot-reload)

📋 Requisitos

• Node.js (v14 o superior)

• PostgreSQL (con la extensión PostGIS)

• npm o yarn

🛠️ Instalación

1. Clona el proyecto:

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

2. Instala las dependencias:

npm install

3. Crea el archivo .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

Las variables heredadas de base de datos única DB_HOST / DB_NAME / DB_USER / DB_PASSWORD siguen siendo compatibles como respaldo.

4. Opcional: personaliza los alias de tablas/dominios en domain-aliases.json para mejorar la selección de tablas mediante lenguaje natural.

🚀 Uso

Modo de desarrollo

npm run dev

Modo de producción

npm run build
npm start

🔧 Configuración de MCP

Puedes usar el siguiente ejemplo de configuración para el servidor 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"
      }
    }
  }
}

📦 Dependencias

• @modelcontextprotocol/sdk: ^1.12.1

• dotenv: ^16.5.0

• pg: ^8.16.0

• zod: ^3.25.64

🤝 Contribución

1. Haz un fork de este repositorio

2. Crea tu rama de características (git checkout -b feature/amazing-feature)

3. Confirma tus cambios (git commit -m 'feat: Add some amazing feature')

4. Sube los cambios a la rama (git push origin feature/amazing-feature)

5. Abre una Pull Request

📝 Licencia

Este proyecto está bajo la Licencia ISC. Consulta el archivo LICENSE para más información.

📧 Contacto

Propietario del proyecto - @receptopalak

Enlace del proyecto: https://github.com/receptopalak/postgis-mcp