Serveur MCP SQL
✓ VérifiéPermet à un client IA d'effectuer des requêtes en lecture seule et l'introspection de schémas sur des bases de données Postgres et SQLite avec des capacités d'écriture sécurisées.
Aussi connu sous Abhishekkumar2021/mcp-suite, @abhishekmcp/sql
- Étoiles
- 1
- Outils
- —
- Téléchargements, 30 jours
- 180
- Dernière version
- 0.1.0
- Dernier commit
- 4 juil. 2026
- Licence
- MIT
Qu'est-ce que SQL MCP ?
SQL est un serveur MCP. Permet à un client IA d'effectuer des requêtes en lecture seule et l'introspection de schémas sur des bases de données Postgres et SQLite avec des capacités d'écriture sécurisées.
Résumé généré à partir du README du projet
À propos du MCP server SQL
Ce serveur permet aux développeurs travaillant avec des données relationnelles d'interroger et d'inspecter des structures de bases de données directement depuis un client IA. Il offre la possibilité d'effectuer des requêtes en lecture seule et l'introspection de schémas sur des bases de données Postgres et SQLite. Le serveur est conçu pour être sûr grâce à des capacités d'écriture contrôlées, garantissant que les modifications de données sont maîtrisées.
Les utilisateurs peuvent connecter cet outil à des clients tels que Claude Desktop, Claude Code ou Cursor. Il est disponible en tant que package npm pour tout client MCP ou en tant que bundle MCPB pour Claude Desktop. Pour SQLite spécifiquement, le serveur utilise le moteur WASM sql.js afin de maintenir une architecture portable et légère en dépendances. Cette configuration permet une exploration efficace des données et une analyse de schéma sans nécessiter de lourdes dépendances natives.
Ce que vous pouvez faire avec
- 1Analyser les schémas de base de donnéesDemandez à l'IA d'expliquer les structures de tables et les relations au sein d'une base de données Postgres ou SQLite.
- 2Exécuter des requêtes de donnéesDemandez à l'IA de récupérer des enregistrements spécifiques ou d'agréger des données à partir de vos tables SQL.
- 3Effectuer des mises à jour de données contrôléesDonnez instruction à l'IA de modifier des entrées de base de données via un processus sécurisé et encadré.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer SQL MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller SQL MCP dans Claude Code
$ claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sqlInstaller SQL MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Installer SQL MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"sql": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Installer SQL MCP dans VS Code CLI
$ code --add-mcp '{"name":"sql","type":"stdio","command":"npx","args":["-y","@abhishekmcp/sql"],"env":{"DB_CONN_default":"<YOUR_DB_CONN_default>"}}'Installer SQL MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Installer SQL MCP dans Codex
$ codex mcp add sql --env 'DB_CONN_default=<YOUR_DB_CONN_default>' -- npx -y @abhishekmcp/sqlInstaller SQL MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.sql] command = "npx" args = ["-y", "@abhishekmcp/sql"] [mcp_servers.sql.env] DB_CONN_default = "<YOUR_DB_CONN_default>"
Installer SQL MCP dans Gemini CLI
$ gemini mcp add -s user -e 'DB_CONN_default=<YOUR_DB_CONN_default>' sql npx -- -y @abhishekmcp/sqlInstaller SQL MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Configuration
DB_CONN_defaultSecretConnection URL for the 'default' connection (postgres://… or sqlite:/abs/path). Additional connections use DB_CONN_<name>. Carries credentials — treated as secret.
DB_WRITABLESet to 1 or true to enable the write tools (execute, execute_script).
NOTES_DIR
| Nom | Description | Type |
|---|---|---|
| DB_CONN_default | Connection URL for the 'default' connection (postgres://… or sqlite:/abs/path). Additional connections use DB_CONN_<name>. Carries credentials — treated as secret. | Secret |
| DB_WRITABLE | Set to 1 or true to enable the write tools (execute, execute_script). | |
| NOTES_DIR | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleabhishekkumar2021/mcp-suite is public and reachablegithub.com/abhishekkumar2021/mcp-suite ↗Réussi
- Le nom du package correspond au dépôt source@abhishekmcp/sql names abhishekkumar2021/mcp-suite as sourcenpmjs.com/package/@abhishekmcp/sql ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-07-04github.com/abhishekkumar2021/mcp-suite ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @abhishekmcp/sqlRéussi
- Aucun avis critique dans le package ou ses dépendances114 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHub🧰 mcp-suite
A collection of Model Context Protocol servers, built in TypeScript.
Each server lives in its own folder under servers/ and publishes to npm as an independent package, while sharing tooling through an npm workspace. Connect them to any MCP client — Claude Desktop, Claude Code, Cursor, and more.
Table of contents
- Servers
- Quickstart
- Install
- Connecting to a client
- Architecture & conventions
- Development
- Adding a new server
- Publishing
- Contributing
- License
Servers
| Server | Description | Status |
|---|---|---|
notes |
Local markdown notes: ranked full-text and semantic search, tags, todos, a [[wiki-link]] knowledge graph, daily notes + templates, and slash-command workflows (prompts) |
✅ Stable |
files |
Sandboxed local filesystem: read, glob + content search, token-efficient edits, copy/move, soft-delete trash, zip, checksums, and dedup | ✅ Stable |
github |
GitHub: search repos/code/issues, read repos/issues/PRs/files, notifications, create issues — OAuth device flow or token | ✅ Stable |
git |
Git: status, log, diff, file history, branches/tags, gated stage/commit, and remote clone/fetch/pull/push — pure-JS, no git binary | ✅ Stable |
sql |
SQL databases: read-only query + schema introspection over Postgres & SQLite, gated writes | ✅ Stable |
http |
HTTP/REST client: ad-hoc requests + saved collections/environments, env secrets, host-allowlisted + SSRF-safe | ✅ Stable |
More on the way: a Spotify controller, and others.
Quickstart
git clone https://github.com/Abhishekkumar2021/mcp-suite.git
cd mcp-suite
npm install # installs deps for every workspace
npm run build # builds every server
Install
Every server ships through every common channel. For the Claude Code plugin, add the marketplace
once — /plugin marketplace add Abhishekkumar2021/mcp-suite — then install per the table. See each
server's README for full config.
| Server | Claude Code plugin | npm (any client) | Claude Desktop (MCPB) | MCP registry |
|---|---|---|---|---|
notes |
/plugin install notes |
npx -y @abhishekmcp/notes |
drag notes-*.mcpb from the latest release |
io.github.Abhishekkumar2021/notes |
files |
/plugin install files |
npx -y @abhishekmcp/files |
drag files-*.mcpb |
io.github.Abhishekkumar2021/files |
github |
/plugin install github |
npx -y @abhishekmcp/github |
drag github-*.mcpb |
io.github.Abhishekkumar2021/github |
git |
/plugin install git |
npx -y @abhishekmcp/git |
drag git-*.mcpb |
io.github.Abhishekkumar2021/git |
sql |
/plugin install sql |
npx -y @abhishekmcp/sql |
drag sql-*.mcpb |
io.github.Abhishekkumar2021/sql |
http |
/plugin install http |
npx -y @abhishekmcp/http |
drag http-*.mcpb |
io.github.Abhishekkumar2021/http |
notesdefaults to~/notes;filesrequiresFS_ROOTS(the directories it may touch). MCPB bundles install via Claude Desktop → Settings → Extensions.
Connecting to a client
Each server's README has full configuration instructions. As an example, to use the notes server with Claude Code:
claude mcp add notes --env NOTES_DIR=$HOME/notes -- node "$(pwd)/servers/notes/dist/index.js"
Or with Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"notes": {
"command": "node",
"args": ["/absolute/path/to/mcp-suite/servers/notes/dist/index.js"],
"env": { "NOTES_DIR": "/absolute/path/to/your/notes" }
}
}
}
Architecture & conventions
A few principles hold across every server:
- Pure-JS/WASM by default; native only when genuinely required. Servers run via
npx/MCPB on any machine, so portable pure-JS/WebAssembly is strongly preferred and a native dependency is used only when genuinely required (gated + documented). In practice these servers are dependency-light:notesuses MiniSearch + WebAssembly embeddings,sqluses thesql.jsWASM SQLite engine, andfilesusesfast-globinstead of ripgrep.npm auditstays clean. - Sandbox-first, layered design. Each server keeps a thin
index.ts(tool registration only) over focused modules, with a single security boundary every path must pass through (realpath-containment, symlink-escape rejection, atomic writes). - Token-efficient by default. Pagination, head/tail/section reads, snippets, and compact graph refs keep tool output small.
- Automated, hands-off releases. A GitHub Release tagged
<server>-v<version>publishes to npm (with provenance), the official MCP registry, and attaches an MCPB bundle — all via OIDC, no secrets. - Tested in CI. Each server ships a committed
node:testsuite (unit + integration/security) run on every push.
Development
This is an npm workspaces monorepo.
npm install # install all workspace dependencies (run once at the root)
npm run build # build every server
npm run build -w servers/notes # build a single server
npm test --workspaces --if-present # run each server's test suite
npm run clean # remove all build output
Adding a new server
- Create
servers/<name>/with its ownpackage.json(unique npmname) and atsconfig.jsonthatextends: "../../tsconfig.base.json". - Put source in
servers/<name>/src/. - Run
npm installat the root so the workspace picks it up. - Add a row to the Servers table above.
All servers follow the naming standard (@abhishekmcp/<slug>). See CONTRIBUTING.md for detailed guidelines.
Publishing
Releases are automated. Cutting a GitHub Release tagged <server>-v<version> triggers
publish.yml, which — authenticated entirely via GitHub OIDC (no
NPM_TOKEN) — publishes the package to npm with provenance, registers it on the official MCP
registry, and builds + attaches the MCPB bundle to the release.
# bump servers/<name>/package.json, commit, then:
gh release create <name>-v<version> --title "<name> v<version>" --notes "…"
Contributing
Contributions are welcome! Please read CONTRIBUTING.md and our Code of Conduct. Found a security issue? See SECURITY.md.
License
MIT © Abhishek
Questions sur SQL MCP
Comment ajouter SQL MCP à Claude Code ?
Exécutez claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sql dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter SQL MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quelles bases de données le serveur SQL prend-il en charge ?
Le serveur prend en charge l'interrogation et l'introspection de schémas pour Postgres et SQLite.
Comment le moteur SQLite est-il implémenté ?
Le serveur utilise le moteur WASM sql.js pour les fonctionnalités SQLite.