MCP (Model Context Protocol) Server for PostgreSQL Database Access. Enables AI models (Claude, Cursor, Ollama, etc.) to safely interact with PostgreSQL databases with read and optional write capabilities.
Three tools with basic descriptions and minimal schemas. Tool names are action-oriented (query_database, modify_data, confirm_modification), but descriptions are in Turkish and lack LLM-optimized structure. Input schemas present but sparse, only 'sql_query' parameter with minimal type info. No output schemas documented. Error handling exists in code but not declared in tool definitions. Security model (two-phase write confirmation) is sound but not reflected in tool annotations or descriptions. Missing parameter constraints, enums, and recovery guidance.
Onaylanan yazma sorgusunu çalıştırır (INSERT, UPDATE, DELETE). Bu tool, modify_data tool'u ile preview alındıktan sonra kullanıcı onayı ile gerçek yazma işlemini gerçekleştirir. Güvenlik: - modify_data ile aynı SQL sorgusu kullanılmalıdır - Sorgu tekrar validasyon ve satır limit kontrolünden geçer - Başarılı ise etkilenen satır sayısını döndürür
Yazma sorgusu preview'ı: Sorguyu doğrular ve kaç satır etkileneceğini gösterir. Bu tool sorguyu ÇALIŞTIRMAZ, sadece preview döndürür. Sorguyu gerçekten çalıştırmak için confirm_modification tool'unu kullanın. Güvenlik kuralları: - Sadece INSERT, UPDATE, DELETE komutları çalıştırılabilir - UPDATE ve DELETE sorgularında WHERE koşulu zorunludur - Tek sorguda etkilenecek satır sayısı sınırlıdır - Sadece izinli tablolara yazma yapılabilir - DDL komutları (DROP, CREATE, ALTER vb.) her zaman engellenir
Güvenli SQL sorgusu çalıştırır (sadece SELECT). Bu tool, AI modellerinin veritabanında sorgu çalıştırmasını sağlar. Güvenlik için sadece SELECT sorguları kabul edilir. Tüm sorgular mevcut SQLValidator ile doğrulanır.
No output schemas documented. LLMs cannot infer what fields to expect from tool responses (e.g., does query_database return rows as array of objects, or a single JSON string?). Forces LLMs to guess and parse unstructured output.
Descriptions are in Turkish and lack LLM-optimized structure. Should state WHAT the tool does, WHEN to use it, and prerequisites in English. Current descriptions bury key details and assume Turkish-speaking LLMs.
No parameter constraints or enums. 'sql_query' accepts free-form strings with no format guidance, length limits, or examples of valid queries. LLMs may pass invalid SQL or extremely long queries.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | <=2025-11-25 | v2 |
Error handling logic exists in code (ValidationError, QueryExecutionError, QueryTimeoutError) but is NOT declared in tool definitions. LLMs cannot plan recovery steps because they don't know what errors are possible.
Two-phase write confirmation (modify_data → confirm_modification) is a strong security pattern but lacks tool annotations. Should use destructiveHint and idempotentHint to signal to LLMs which operations are reversible.