MCP server SQL
✓ ПровереноПозволяет AI-клиенту выполнять запросы только для чтения и интроспекцию схем в базах данных Postgres и SQLite с ограниченными возможностями записи.
Также известен как Abhishekkumar2021/mcp-suite, @abhishekmcp/sql
- Звёзды
- 1
- Инструменты
- —
- Загрузки, 30 дней
- 180
- Последняя версия
- 0.1.0
- Последний коммит
- 4 июл. 2026 г.
- Лицензия
- MIT
Что такое SQL MCP?
SQL — это MCP server. Позволяет AI-клиенту выполнять запросы только для чтения и интроспекцию схем в базах данных Postgres и SQLite с ограниченными возможностями записи.
Сводка сгенерирована из README проекта
О SQL MCP server
Этот сервер позволяет разработчикам, работающим с реляционными данными, выполнять запросы и анализировать структуру баз данных прямо из AI-клиента. Он предоставляет возможность выполнять запросы только для чтения и проводить интроспекцию схем в базах данных Postgres и SQLite. Для обеспечения безопасности сервер использует механизм ограниченного доступа к записи, что гарантирует контроль над любыми изменениями данных.
Пользователи могут подключить этот инструмент к таким клиентам, как Claude Desktop, Claude Code или Cursor. Он доступен в виде npm-пакета для любого MCP-клиента или в виде MCPB-бандла для Claude Desktop. Что касается SQLite, сервер использует движок sql.js WASM для поддержания портативной архитектуры с минимумом зависимостей. Такая конфигурация позволяет эффективно исследовать данные и анализировать схемы без необходимости установки тяжелых нативных зависимостей.
Что вы можете с ним делать
- 1Анализ схем баз данныхПопросите AI объяснить структуру таблиц и связи внутри базы данных Postgres или SQLite.
- 2Выполнение запросов к даннымДайте AI команду извлечь определенные записи или агрегировать данные из ваших SQL-таблиц.
- 3Контролируемое обновление данныхДайте AI инструкцию изменить записи в базе данных через безопасный, ограниченный процесс.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить SQL MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка SQL MCP в Claude Code
$ claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sqlУстановка SQL MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Установка SQL MCP в VS Code
.vscode/mcp.json
{
"servers": {
"sql": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Установка SQL MCP в VS Code CLI
$ code --add-mcp '{"name":"sql","type":"stdio","command":"npx","args":["-y","@abhishekmcp/sql"],"env":{"DB_CONN_default":"<YOUR_DB_CONN_default>"}}'Установка SQL MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Установка SQL MCP в Codex
$ codex mcp add sql --env 'DB_CONN_default=<YOUR_DB_CONN_default>' -- npx -y @abhishekmcp/sqlУстановка SQL MCP в 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>"
Установка SQL MCP в Gemini CLI
$ gemini mcp add -s user -e 'DB_CONN_default=<YOUR_DB_CONN_default>' sql npx -- -y @abhishekmcp/sqlУстановка SQL MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Конфигурация
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.
DB_WRITABLESet to 1 or true to enable the write tools (execute, execute_script).
NOTES_DIR
| Название | Описание | Тип |
|---|---|---|
| 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. | Секрет |
| DB_WRITABLE | Set to 1 or true to enable the write tools (execute, execute_script). | |
| NOTES_DIR | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийabhishekkumar2021/mcp-suite is public and reachablegithub.com/abhishekkumar2021/mcp-suite ↗Пройдено
- Пакет указывает этот репозиторий как источник@abhishekmcp/sql names abhishekkumar2021/mcp-suite as sourcenpmjs.com/package/@abhishekmcp/sql ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-07-04github.com/abhishekkumar2021/mcp-suite ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @abhishekmcp/sqlПройдено
- Нет критических предупреждений в пакете или его зависимостях114 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на 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
Вопросы о SQL MCP
Как добавить SQL MCP в Claude Code?
Выполните claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sql в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить SQL MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие базы данных поддерживает SQL server?
Сервер поддерживает выполнение запросов и интроспекцию схем как для Postgres, так и для SQLite.
Как реализован движок SQLite?
Для обеспечения функциональности SQLite сервер использует движок sql.js WASM.