SQL MCP server
✓ 인증됨AI 클라이언트가 Postgres 및 SQLite 데이터베이스에 대해 읽기 전용 쿼리 및 스키마 조사를 수행할 수 있으며, 제한된 쓰기 권한을 제공합니다.
다른 이름 Abhishekkumar2021/mcp-suite, @abhishekmcp/sql
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- 180
- 최신 버전
- 0.1.0
- 마지막 커밋
- 2026년 7월 4일
- 라이선스
- MIT
SQL MCP란?
SQL은(는) MCP server입니다. AI 클라이언트가 Postgres 및 SQLite 데이터베이스에 대해 읽기 전용 쿼리 및 스키마 조사를 수행할 수 있으며, 제한된 쓰기 권한을 제공합니다.
프로젝트 README에서 생성된 요약
SQL MCP server 정보
이 server는 관계형 데이터를 다루는 개발자가 AI 클라이언트 내부에서 데이터베이스 구조를 쿼리하고 조사할 수 있도록 지원합니다. Postgres와 SQLite 데이터베이스 모두에서 읽기 전용 쿼리 및 스키마 조사를 수행할 수 있는 기능을 제공합니다. 데이터 수정이 통제될 수 있도록 제한된 쓰기 권한을 사용하여 안전하게 설계되었습니다.
사용자는 이 도구를 Claude Desktop, Claude Code 또는 Cursor와 같은 클라이언트에 연결할 수 있습니다. 모든 MCP 클라이언트를 위한 npm 패키지 또는 Claude Desktop을 위한 MCPB 번들로 사용할 수 있습니다. 특히 SQLite의 경우, 이 server는 sql.js WASM 엔진을 활용하여 휴대성이 높고 의존성이 적은 아키텍처를 유지합니다. 이러한 설정을 통해 무거운 네이티브 의존성 없이도 효율적인 데이터 탐색 및 스키마 분석이 가능합니다.
활용 사례
- 1데이터베이스 스키마 분석AI에게 Postgres 또는 SQLite 데이터베이스 내의 테이블 구조와 관계를 설명하도록 요청합니다.
- 2데이터 쿼리 실행AI에게 SQL 테이블에서 특정 레코드를 검색하거나 데이터를 집계하도록 요청합니다.
- 3제어된 데이터 업데이트 수행보안이 적용된 제한된 프로세스를 통해 AI가 데이터베이스 항목을 수정하도록 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SQL MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SQL MCP 설치
$ claude mcp add --env 'DB_CONN_default=<YOUR_DB_CONN_default>' sql -- npx -y @abhishekmcp/sqlCursor에 SQL MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}VS Code에 SQL MCP 설치
.vscode/mcp.json
{
"servers": {
"sql": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}VS Code CLI에 SQL MCP 설치
$ code --add-mcp '{"name":"sql","type":"stdio","command":"npx","args":["-y","@abhishekmcp/sql"],"env":{"DB_CONN_default":"<YOUR_DB_CONN_default>"}}'Claude Desktop에 SQL MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"sql": {
"command": "npx",
"args": [
"-y",
"@abhishekmcp/sql"
],
"env": {
"DB_CONN_default": "<YOUR_DB_CONN_default>"
}
}
}
}Codex에 SQL MCP 설치
$ codex mcp add sql --env 'DB_CONN_default=<YOUR_DB_CONN_default>' -- npx -y @abhishekmcp/sqlCodex config.toml에 SQL MCP 설치
~/.codex/config.toml
[mcp_servers.sql] command = "npx" args = ["-y", "@abhishekmcp/sql"] [mcp_servers.sql.env] DB_CONN_default = "<YOUR_DB_CONN_default>"
Gemini CLI에 SQL MCP 설치
$ gemini mcp add -s user -e 'DB_CONN_default=<YOUR_DB_CONN_default>' sql npx -- -y @abhishekmcp/sqlGemini settings.json에 SQL MCP 설치
~/.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 | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능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검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스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는 어떤 데이터베이스를 지원하나요?
이 server는 Postgres와 SQLite 모두에 대한 쿼리 및 스키마 조사를 지원합니다.
SQLite 엔진은 어떻게 구현되어 있나요?
이 server는 SQLite 기능을 위해 sql.js WASM 엔진을 사용합니다.