ajan-sql

<p align="center"> </p>

<p align="center"> <a href="https://www.npmjs.com/package/ajan-sql"> </a> <a href="https://www.npmjs.com/package/ajan-sql"> </a> <a href="https://github.com/borakilicoglu/ajan-sql/releases"> </a> <a href="https://borakilicoglu.github.io/ajan-sql/"> </a> <a href="./LICENSE"> </a> </p>

<p align="center"> <a href="https://github.com/borakilicoglu/ajan-sql">GitHub Repository</a> </p>

<p align="center"> <a href="https://www.npmjs.com/package/ajan-sql">npm Package</a> </p>

<p align="center"> AI-safe MCP server for schema-aware, read-only SQL access. </p>

ajan-sql is an npm package for running an MCP server over stdio with a PostgreSQL backend.

• Safe, read-only database access for AI agents
• Schema inspection and table discovery
• Reliable PostgreSQL query execution with strict guardrails
• Simple, maintainable implementation

• Node.js
• TypeScript
• MCP TypeScript SDK v1.x
• PostgreSQL via pg

All executed queries must follow these rules:

• SELECT only
• Reject INSERT
• Reject UPDATE
• Reject DELETE
• Reject DROP
• Reject ALTER
• Reject TRUNCATE
• Enforce LIMIT with a default of 100
• Enforce query timeout with a maximum of 5 seconds
• Enforce maximum result size
• Reject multi-statement SQL
• Reject SQL comments

These rules should never be bypassed.

• list_tables
• describe_table
• list_relationships
• run_readonly_query
• `