@neverinfamous/postgres-mcp 1.0.1

package/dist/adapters/postgresql/tools/postgis/standalone.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PostgreSQL PostGIS Extension Tools - Standalone Geometry Operations
+ *
+ * Tools for operating on geometry strings (WKT/GeoJSON) directly,
+ * without requiring a table. These complement the table-based tools.
+ */
+import type { PostgresAdapter } from "../../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../../types/index.js";
+/**
+ * Create buffer around a standalone geometry
+ */
+export declare function createGeometryBufferTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Compute intersection of two standalone geometries
+ */
+export declare function createGeometryIntersectionTool(adapter: PostgresAdapter): ToolDefinition;
+/**
+ * Transform a standalone geometry between coordinate systems
+ */
+export declare function createGeometryTransformTool(adapter: PostgresAdapter): ToolDefinition;
+//# sourceMappingURL=standalone.d.ts.map

package/dist/adapters/postgresql/tools/postgis/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/postgis/standalone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AA2CpC;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,GACvB,cAAc,CAuDhB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,eAAe,GACvB,cAAc,CAuChB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,cAAc,CA8BhB"}

package/dist/adapters/postgresql/tools/postgis/standalone.js

@@ -0,0 +1,150 @@
+/**
+ * PostgreSQL PostGIS Extension Tools - Standalone Geometry Operations
+ *
+ * Tools for operating on geometry strings (WKT/GeoJSON) directly,
+ * without requiring a table. These complement the table-based tools.
+ */
+import { readOnly } from "../../../../utils/annotations.js";
+import { getToolIcons } from "../../../../utils/icons.js";
+import { GeometryBufferSchemaBase, GeometryBufferSchema, GeometryIntersectionSchemaBase, GeometryIntersectionSchema, GeometryTransformSchemaBase, GeometryTransformSchema, } from "../../schemas/index.js";
+/**
+ * Detect if a geometry string is GeoJSON or WKT
+ */
+function parseGeometry(geometry) {
+    const trimmed = geometry.trim();
+    const isGeoJson = trimmed.startsWith("{");
+    return {
+        sql: isGeoJson ? "ST_GeomFromGeoJSON($1)" : "ST_GeomFromText($1)",
+        isGeoJson,
+    };
+}
+/**
+ * Parse geometry with explicit SRID normalization for intersection operations.
+ * This ensures both GeoJSON (which has implicit SRID 4326) and WKT (no SRID)
+ * use consistent coordinate systems.
+ */
+function parseGeometryWithSrid(geometry, srid = 4326) {
+    const trimmed = geometry.trim();
+    const isGeoJson = trimmed.startsWith("{");
+    // GeoJSON uses 4326 implicitly; WKT has no SRID. Normalize both.
+    const baseExpr = isGeoJson ? "ST_GeomFromGeoJSON($1)" : "ST_GeomFromText($1)";
+    return {
+        sql: `ST_SetSRID(${baseExpr}, ${String(srid)})`,
+        isGeoJson,
+    };
+}
+/**
+ * Create buffer around a standalone geometry
+ */
+export function createGeometryBufferTool(adapter) {
+    return {
+        name: "pg_geometry_buffer",
+        description: "Create a buffer zone around a WKT or GeoJSON geometry. Returns the buffered geometry as GeoJSON and WKT.",
+        group: "postgis",
+        inputSchema: GeometryBufferSchemaBase, // Base schema for MCP visibility
+        annotations: readOnly("Geometry Buffer"),
+        icons: getToolIcons("postgis", readOnly("Geometry Buffer")),
+        handler: async (params, _context) => {
+            const { geometry, distance, srid, simplify } = GeometryBufferSchema.parse(params ?? {});
+            const sridVal = srid ?? 4326;
+            const { sql: geomExpr, isGeoJson } = parseGeometry(geometry);
+            // Build buffer expression
+            const bufferExpr = `ST_Buffer(ST_SetSRID(${geomExpr}, ${String(sridVal)})::geography, $2)::geometry`;
+            // Apply optional simplification
+            const outputExpr = simplify !== undefined && simplify > 0
+                ? `ST_Simplify(${bufferExpr}, ${String(simplify / 111000)})` // Convert meters to degrees approx
+                : bufferExpr;
+            const sql = `
+                SELECT 
+                    ST_AsGeoJSON(${outputExpr}) as buffer_geojson,
+                    ST_AsText(${outputExpr}) as buffer_wkt,
+                    $2 as distance_meters,
+                    ${String(sridVal)} as srid
+            `;
+            const result = await adapter.executeQuery(sql, [geometry, distance]);
+            const row = result.rows?.[0];
+            const response = {
+                ...row,
+                inputFormat: isGeoJson ? "GeoJSON" : "WKT",
+            };
+            // Include simplification info if applied
+            if (simplify !== undefined && simplify > 0) {
+                response["simplified"] = true;
+                response["simplifyTolerance"] = simplify;
+                // Check if simplification caused geometry to collapse to null
+                if (row?.["buffer_geojson"] === null || row?.["buffer_wkt"] === null) {
+                    response["warning"] =
+                        `Simplification tolerance (${String(simplify)}m) is too high relative to buffer distance (${String(distance)}m). The geometry collapsed to null. Reduce simplify value or set simplify: 0 to disable.`;
+                }
+            }
+            return response;
+        },
+    };
+}
+/**
+ * Compute intersection of two standalone geometries
+ */
+export function createGeometryIntersectionTool(adapter) {
+    return {
+        name: "pg_geometry_intersection",
+        description: "Compute the intersection of two WKT or GeoJSON geometries. Returns the intersection geometry and whether they intersect.",
+        group: "postgis",
+        inputSchema: GeometryIntersectionSchemaBase, // Base schema for MCP visibility
+        annotations: readOnly("Geometry Intersection"),
+        icons: getToolIcons("postgis", readOnly("Geometry Intersection")),
+        handler: async (params, _context) => {
+            const { geometry1, geometry2 } = GeometryIntersectionSchema.parse(params ?? {});
+            // Use SRID-normalized parsing to prevent mixed SRID errors when combining
+            // GeoJSON (implicit SRID 4326) with WKT (no SRID)
+            const geom1 = parseGeometryWithSrid(geometry1);
+            const geom2 = parseGeometryWithSrid(geometry2);
+            // geom1 uses $1 (first parameter), geom2 uses $2 (second parameter)
+            const geom1Expr = geom1.sql;
+            const geom2Expr = geom2.sql.replace("$1", "$2");
+            const sql = `
+                SELECT 
+                    ST_Intersects(${geom1Expr}, ${geom2Expr}) as intersects,
+                    ST_AsGeoJSON(ST_Intersection(${geom1Expr}, ${geom2Expr})) as intersection_geojson,
+                    ST_AsText(ST_Intersection(${geom1Expr}, ${geom2Expr})) as intersection_wkt,
+                    ST_Area(ST_Intersection(${geom1Expr}, ${geom2Expr})::geography) as intersection_area_sqm
+            `;
+            const result = await adapter.executeQuery(sql, [geometry1, geometry2]);
+            return {
+                ...result.rows?.[0],
+                geometry1Format: geom1.isGeoJson ? "GeoJSON" : "WKT",
+                geometry2Format: geom2.isGeoJson ? "GeoJSON" : "WKT",
+                sridUsed: 4326,
+            };
+        },
+    };
+}
+/**
+ * Transform a standalone geometry between coordinate systems
+ */
+export function createGeometryTransformTool(adapter) {
+    return {
+        name: "pg_geometry_transform",
+        description: "Transform a WKT or GeoJSON geometry from one SRID to another. Common SRIDs: 4326 (WGS84/GPS), 3857 (Web Mercator).",
+        group: "postgis",
+        inputSchema: GeometryTransformSchemaBase, // Base schema for MCP visibility
+        annotations: readOnly("Geometry Transform"),
+        icons: getToolIcons("postgis", readOnly("Geometry Transform")),
+        handler: async (params, _context) => {
+            const { geometry, fromSrid, toSrid } = GeometryTransformSchema.parse(params ?? {});
+            const { sql: geomExpr, isGeoJson } = parseGeometry(geometry);
+            const sql = `
+                SELECT 
+                    ST_AsGeoJSON(ST_Transform(ST_SetSRID(${geomExpr}, ${String(fromSrid)}), ${String(toSrid)})) as transformed_geojson,
+                    ST_AsText(ST_Transform(ST_SetSRID(${geomExpr}, ${String(fromSrid)}), ${String(toSrid)})) as transformed_wkt
+            `;
+            const result = await adapter.executeQuery(sql, [geometry]);
+            return {
+                ...result.rows?.[0],
+                fromSrid,
+                toSrid,
+                inputFormat: isGeoJson ? "GeoJSON" : "WKT",
+            };
+        },
+    };
+}
+//# sourceMappingURL=standalone.js.map

package/dist/adapters/postgresql/tools/postgis/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/postgis/standalone.ts"],"names":[],"mappings":"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"}

package/dist/adapters/postgresql/tools/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PostgreSQL Schema Management Tools
+ *
+ * Schema DDL operations: schemas, sequences, views, functions, triggers.
+ * 12 tools total.
+ */
+import type { PostgresAdapter } from "../PostgresAdapter.js";
+import type { ToolDefinition } from "../../../types/index.js";
+/**
+ * Get all schema management tools
+ */
+export declare function getSchemaTools(adapter: PostgresAdapter): ToolDefinition[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/adapters/postgresql/tools/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/adapters/postgresql/tools/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,yBAAyB,CAAC;AAoB9E;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,EAAE,CAezE"}