MCP server SQL
✓ VerificadoPermite que um cliente de IA realize consultas apenas de leitura e introspecção de esquema em bancos de dados Postgres e SQLite com capacidades de escrita controladas.
Também conhecido como Abhishekkumar2021/mcp-suite, @abhishekmcp/sql
- Stars
- 1
- Ferramentas
- —
- Downloads, 30 dias
- 180
- Versão mais recente
- 0.1.0
- Último commit
- 4 de jul. de 2026
- Licença
- MIT
O que é o MCP SQL?
SQL é um MCP server. Permite que um cliente de IA realize consultas apenas de leitura e introspecção de esquema em bancos de dados Postgres e SQLite com capacidades de escrita controladas.
Resumo gerado a partir do README do projeto
Sobre o MCP server de SQL
Consultar e inspecionar estruturas de banco de dados diretamente de um cliente de IA é o que este servidor permite para desenvolvedores que trabalham com dados relacionais. Ele oferece a capacidade de realizar consultas apenas de leitura e introspecção de esquema em bancos de dados Postgres e SQLite. O servidor foi projetado para ser seguro por meio do uso de capacidades de escrita controladas, garantindo que as modificações de dados sejam monitoradas.
Os usuários podem conectar esta ferramenta a clientes como Claude Desktop, Claude Code ou Cursor. Ele está disponível como um pacote npm para qualquer cliente MCP ou como um bundle MCPB para Claude Desktop. Especificamente para o SQLite, o servidor utiliza o mecanismo sql.js WASM para manter uma arquitetura portátil e com poucas dependências. Essa configuração permite uma exploração de dados e análise de esquema eficientes sem a necessidade de dependências nativas pesadas.
O que você pode fazer com ele
- 1Analisar esquemas de banco de dadosPeça à IA para explicar as estruturas de tabelas e os relacionamentos dentro de um banco de dados Postgres ou SQLite.
- 2Executar consultas de dadosSolicite à IA que recupere registros específicos ou agregue dados de suas tabelas SQL.
- 3Realizar atualizações de dados controladasInstrua a IA a modificar entradas no banco de dados por meio de um processo seguro e controlado.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP SQL
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP SQL no Claude Code
$ claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sqlInstalar o MCP SQL no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Instalar o MCP SQL no VS Code
.vscode/mcp.json
{
"servers": {
"sql": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Instalar o MCP SQL no VS Code CLI
$ code --add-mcp '{"name":"sql","type":"stdio","command":"npx","args":["-y","@abhishekmcp/sql"],"env":{"DB_CONN_default":"<YOUR_DB_CONN_default>"}}'Instalar o MCP SQL no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Instalar o MCP SQL no Codex
$ codex mcp add sql --env 'DB_CONN_default=<YOUR_DB_CONN_default>' -- npx -y @abhishekmcp/sqlInstalar o MCP SQL no 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>"
Instalar o MCP SQL no Gemini CLI
$ gemini mcp add -s user -e 'DB_CONN_default=<YOUR_DB_CONN_default>' sql npx -- -y @abhishekmcp/sqlInstalar o MCP SQL no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Configuração
DB_CONN_defaultSecretoConnection 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
| Nome | Descrição | Tipo |
|---|---|---|
| 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. | Secreto |
| DB_WRITABLE | Set to 1 or true to enable the write tools (execute, execute_script). | |
| NOTES_DIR | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelabhishekkumar2021/mcp-suite is public and reachablegithub.com/abhishekkumar2021/mcp-suite ↗Passou
- O pacote indica este repositório como sua origem@abhishekmcp/sql names abhishekkumar2021/mcp-suite as sourcenpmjs.com/package/@abhishekmcp/sql ↗Passou
- Proveniência da build (atestação Sigstore)No build attestation published for this releaseNão verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-07-04github.com/abhishekkumar2021/mcp-suite ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @abhishekmcp/sqlPassou
- Nenhum aviso crítico no pacote ou em suas dependências114 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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
Perguntas sobre o MCP SQL
Como adiciono o MCP SQL ao Claude Code?
Execute claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sql no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP SQL ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais bancos de dados o servidor SQL suporta?
O servidor suporta consultas e introspecção de esquema tanto para Postgres quanto para SQLite.
Como o mecanismo SQLite é implementado?
O servidor utiliza o mecanismo sql.js WASM para a funcionalidade SQLite.