MCP MSSQL
ismailcankaratas/mcp-mssql
Acesse SQL Server do Claude com segurança e consultas em linguagem natural
Ver no GitHubServidor MCP que conecta Claude ao SQL Server com segurança via STDIO, permitindo consultas SQL através de linguagem natural. Oferece descoberta de schema automática e execução segura de SELECT com guardrails contra DDL/DML, ideal para análise de dados em banco SQL Server.
Instalação
npx convez-ai ismailcankaratas/mcp-mssql1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consultar dados SQL Server usando linguagem natural
- Descobrir automaticamente schema e estrutura de tabelas
- Análise de dados com proteção contra operações perigosas
- Integrar Claude como ferramenta de BI/analytics para bancos SQL Server
Veredito

MCP bem estruturado para integração Claude + SQL Server, com guardrails sólidos (SELECT-only, timeout, TOP automático). Ideal para analistas e engenheiros que precisam de acesso seguro a dados em ambiente empresarial, embora requeira setup inicial de credenciais e certificados SSL em produção.
README
A tradução para o português deste README ainda está na fila.
mcp-mssql — Claude için MSSQL MCP Sunucusu
MSSQL’e Model Context Protocol (MCP) üzerinden güvenli bağlanan, STDIO modunda çalışan bir sunucudur.
Claude Desktop (ve MCP uyumlu diğer istemciler) tarafından harici bir tool olarak başlatılır.
NL→SQL: doğal dilde sor — Claude şemayı (discover_schema) kullanarak SQL üretir ve
run_sql_safeile çalıştırır.
✨ Özellikler
- connect_db — Ortam değişkenleriyle MSSQL bağlantısını dener (sağlık kontrolü).
- discover_schema —
INFORMATION_SCHEMAtabanlı tablo/kolon keşfi; basit heuristiklerledate_cols,measures,dimsetiketleri üretir. - run_sql_safe — Tek
SELECTifadesini çalıştırır. DDL/DML ve çoklu ifadeler engellenir. OtomatikTOP 5000enjekte edilir (sorguda varsa dokunmaz).
🛡️ Guardrails:
DROP/UPDATE/INSERT/MERGE/EXECvb. yasak;;,--,/* */gibi çoklu ifade/yorum kalıpları reddedilir; 15 sn timeout.
🧰 Gereksinimler
- Node.js 18+ (öneri: 20+)
- MSSQL (lokal / Docker / uzak / Azure SQL)
🔧 Kurulum
git clone https://github.com/ismailcankaratas/mcp-mssql.git
cd mcp-mssql
npm install
.env oluştur (repo kökünde):
MSSQL_HOST=localhost
MSSQL_PORT=1433
MSSQL_DB=YourDatabase
MSSQL_USER=readonly_login
MSSQL_PWD=ReadOnly!123
Geliştirmede
encrypt=truevetrustServerCertificate=truevarsayılan. Üretimde geçerli sertifika ileencrypt=truekullanın.
▶️ Çalıştırma
Geliştirme (TSX ile)
npm run dev
Build & Start
npm run build
npm start
🧪 Hızlı Bağlantı Testi
npx tsx src/test_local.ts
Beklenen:
OK: [ { current_db: "...", version: "Microsoft SQL Server 2022 ..." } ]
🖥️ Claude Desktop Entegrasyonu
Config dosyası (claude_desktop_config.json) örneği:
{
"mcpServers": {
"mssql": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/dist/server.js"],
"env": {
"MSSQL_HOST": "localhost",
"MSSQL_PORT": "1433",
"MSSQL_DB": "YourDatabase",
"MSSQL_USER": "readonly_login",
"MSSQL_PWD": "ReadOnly!123"
}
}
}
}
Geliştirmede TS kaynakla koşmak istersen
Command: "tsx",Args: ["src/server.ts"]kullanabilirsin.
🧭 Claude içinde kullanım örnekleri
- Bağlantı testi
tool: connect_db {} - Şemayı keşfet
tool: discover_schema {} - Güvenli sorgu çalıştır
tool: run_sql_safe {"sql":"SELECT TOP 5 name FROM sys.databases ORDER BY name"}
NL→SQL: doğal dilde sor — Claude şemayı (discover_schema) kullanarak SQL üretir ve
run_sql_safeile çalıştırır.
🔒 Güvenlik Notları
- Üretimde salt-okuma kullanıcı (
db_datareader) kullanın. run_sql_safeyalnızca tek bir SELECT’e izin verir; DDL/DML ve çoklu ifadeler reddedilir.- Maksimum satır sayısı için
TOPotomatik enjekte edilir (varsayılan: 5000). - Sorgu süresi varsayılan 15s timeout ile sınırlıdır.
.envve gizli bilgileri asla versiyona eklemeyin.
🩺 Sorun Giderme
- ENOTFOUND / ECONNREFUSED / ETIMEDOUT → Host/port doğru mu? Docker portu açık mı?
- ELOGIN → Kullanıcı/parola doğru mu? DB’de
db_datareaderyetkisi var mı? - TLS uyarısı (SNI) → IP yerine
MSSQL_HOST=localhostkullanın veya sertifika tanımlayın. - discover_schema boş → DB’de tablo yok ya da kullanıcı
INFORMATION_SCHEMA’ya erişemiyor.
📂 Proje Yapısı
src/
db.ts # MSSQL bağlantısı ve query helper
schema.ts # INFORMATION_SCHEMA keşfi + heuristik etiketler
server.ts # MCP server (connect_db, discover_schema, run_sql_safe)
test_local.ts # MSSQL bağlantı smoke testi
📄 Lisans
MIT