sql-mcp — Concept Overview¶
Built on
scion-sdk— the unified AGI Harness.
Description¶
PostgreSQL, MySQL/MariaDB, Microsoft SQL Server, Oracle, and SQLite over SQLAlchemy 2.x Core. Read-only by default, with server-side write gating, bound parameters everywhere, row caps, and statement timeouts.
Architecture¶
This project follows the standardized agent-package pattern:
- Modular Design: split into
api/(theSqlApiSQLAlchemy 2.x Core facade — all business logic) andmcp/(the non-client tools; every client operation is served as its own typed tool) for cleaner organization. - Dynamic Tool Registration: dynamic tool tags, strictly
lowercase, each togglable with a
*TOOLenvironment flag (SQLTOOL). - Safety boundary:
sql_mcp.safety.assert_read_only(allowlist + CTE depth-zero scan) guards everysql_querystatement; writes require the server-sideSQL_ALLOW_WRITES=Trueswitch.
Concept Registry¶
This project implements or inherits the following ecosystem concepts:
| Concept ID | Description | Source |
|---|---|---|
| ECO-4.1 | MCP & Universal Skills | scion-sdk (inherited) |
| CONCEPT:SQ-OS.governance.sql-2 | Action-dispatch MCP tool surface | concepts.md |
| CONCEPT:SQ-OS.safety.allow-deny-classification | Read-only statement gate | concepts.md |
📖 Full Registry: See
scion-sdk/docs/overview.mdfor the complete 5-Pillar concept index.