Ajan SQL

Safe, read-only SQL access for AI agents — via MCP.

______________________________________________________________________

⚡ 什么是ajan sql？

ajan-sql 是一个MCP服务器，允许AI代理安全地查询您的数据库。

👉 只读\ 👉 模式感知\ 👉 装有护栏的

支持：

• PostgreSQL
• MySQL
• SQLite

______________________________________________________________________

🚀 快速开始

DATABASE_URL=postgres://USER:PASSWORD@HOST:PORT/DB npx ajan-sql

就是这样。

______________________________________________________________________

🧠 它解决了什么

人工智能代理查询数据库是有风险的。

无护栏：

• 他们可以修改数据
• 运行繁重的查询
• 破坏你的系统

👉 ajan-sql 通过执行严格的规则来解决这个问题。

______________________________________________________________________

🔥 默认安全

所有查询均为：

• SELECT 仅
• 不 INSERT, UPDATE, DELETE
• 不 DROP, ALTER, TRUNCATE
• 有限的结果(LIMIT 100)
• 强制超时（最多5秒）
• 无多语句查询
• 没有SQL注释

👉 这些规则是不能绕过的。

______________________________________________________________________

⚡ 可用工具

• list_tables
• describe_table
• list_relationships
• search_schema
• run_readonly_query
• explain_query
• sample_rows
• server_info

______________________________________________________________________

🧠 示例

{
  "tool": "run_readonly_query",
  "arguments": {
    "sql": "SELECT * FROM users LIMIT 10"
  }
}

工具响应包括标准MCP structuredContent 以及嵌入式 text/toon 同一有效载荷的版本。

______________________________________________________________________

🌐 支持的数据库

# PostgreSQL
DATABASE_DIALECT=postgres
DATABASE_URL=postgres://USER:PASSWORD@HOST:PORT/DB

# MySQL
DATABASE_DIALECT=mysql
DATABASE_URL=mysql://USER:PASSWORD@HOST:PORT/DB

# SQLite
DATABASE_DIALECT=sqlite
DATABASE_URL=file:/absolute/path/to/database.sqlite

______________________________________________________________________

⚙️ 特性

• MCP本机SQL访问
• 多数据库支持
• 严格的只读护栏
• 模式发现+自省
• AI代理的结构化JSON输出
• TOON格式的嵌入式工具结果
• 可预测的执行限制
• 类型安全架构

______________________________________________________________________

🧠 用例

• AI副驾驶查询数据库
• 内部数据助理
• 分析代理
• 自动化中的安全数据库访问
• 基于MCP的工作流

______________________________________________________________________

📦 安装

npm install -g ajan-sql

或者：

npx ajan-sql

______________________________________________________________________

🧩 客户端示例

{
  "mcpServers": {
    "ajan-sql": {
      "command": "npx",
      "args": ["ajan-sql"],
      "env": {
        "DATABASE_DIALECT": "postgres",
        "DATABASE_URL": "postgres://USER:PASSWORD@HOST:PORT/DB"
      }
    }
  }
}

______________________________________________________________________

💡 哲学

AI永远不应该有不安全的数据库访问。

ajan-sql 确保查询是安全的、可预测的和可控的。

______________________________________________________________________

❤️ 支持

如果此工具可以帮助您：

⭐ 标记回购\ ☕ 通过GitHub赞助商提供支持

https://github.com/sponsors/borakilicoglu

______________________________________________________________________

🔗 链接

• github：https://github.com/borakilicoglu/ajan-sql
• npm：https://www.npmjs.com/package/ajan-sql
• 文件：https://borakilicoglu.github.io/ajan-sql/