Microsoft SQL MCP sunucusu
Bir AI istemcisinin SQL Server şemalarını güvenli bir şekilde keşfetmesine ve salt okunur SELECT sorguları çalıştırmasına olanak tanır.
Ayrıca bilinen adı bilims/mcp-sqlserver, @bilims/mcp-sqlserver
- Yıldızlar
- 47
- Araçlar
- 8
- İndirmeler, 30 gün
- 4.376
- En son sürüm
- —
- Son commit
- 31 Mar 2026
- Lisans
- MIT
Microsoft SQL MCP nedir?
Microsoft SQL bir MCP sunucusudur. Bir AI istemcisinin SQL Server şemalarını güvenli bir şekilde keşfetmesine ve salt okunur SELECT sorguları çalıştırmasına olanak tanır. 8 araç sunar; örneğin list_databases, list_tables, list_views.
Özet, projenin README dosyasından oluşturuldu
Microsoft SQL MCP sunucusu hakkında
Bu server, Microsoft SQL Server şemalarını keşfetmeyi ve bir AI istemcisi üzerinden salt okunur sorgular çalıştırmayı sağlar. Geliştiricilerin ve veri analistlerinin; Claude Desktop veya Claude Code CLI gibi araçlar aracılığıyla doğal dil kullanarak Azure SQL Database, on-premises SQL Server veya yerel SQL Server Express örnekleriyle etkileşime girmesine imkan tanır. Server; host, kullanıcı, şifre ve veritabanı adı gibi ortam değişkenleri aracılığıyla veritabanınıza bağlanarak çalışır.
Güvenlik temel odak noktasıdır; server, kazara veri değişikliğini önlemek için işlemleri yalnızca salt okunur SELECT ifadeleriyle sınırlar. SQL injection saldırılarına karşı yerleşik korumalar içerir ve INSERT veya DELETE gibi tehlikeli anahtar kelimeleri engellemek için bir kara liste kullanır. Kullanıcılar; list_tables, describe_table ve get_foreign_keys gibi araçları kullanarak veritabanı yapılarını keşfedebilirler. Veri alımı için execute_query aracı, karmaşık sorgular sırasında kararlılığı sağlamak amacıyla yapılandırılabilir satır limitleri ve zaman aşımları ile güvenli keşif imkanı sunar.
Neler yapabilirsiniz
- 1Veritabanı yapılarını keşfedinBelirli bir veritabanı şeması içindeki tüm tabloları ve sütun tanımlarını belirlemesi için AI'ya komut verin.
- 2Tablo ilişkilerini analiz edinFarklı tabloların yabancı anahtarlar (foreign keys) aracılığıyla nasıl bağlandığına dair bir özet isteyin.
- 3Örnek verileri çekinİnceleme yapmak amacıyla belirli bir tablodan sınırlı sayıda kaydı getirmek için doğal dili kullanın.
- 4Tablo boyutlarını denetleyinVeritabanındaki hangi tabloların en çok alanı kapladığını veya en çok satır içerdiğini tespit edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Microsoft SQL MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleMicrosoft SQL MCP'yi Claude Code içine yükleyin
$ claude mcp add mcp-sqlserver -- npx -y @bilims/mcp-sqlserverMicrosoft SQL MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-sqlserver": {
"command": "npx",
"args": [
"-y",
"@bilims/mcp-sqlserver"
]
}
}
}Microsoft SQL MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp-sqlserver": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bilims/mcp-sqlserver"
]
}
}
}Microsoft SQL MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp-sqlserver","type":"stdio","command":"npx","args":["-y","@bilims/mcp-sqlserver"]}'Microsoft SQL MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp-sqlserver": {
"command": "npx",
"args": [
"-y",
"@bilims/mcp-sqlserver"
]
}
}
}Microsoft SQL MCP'yi Codex içine yükleyin
$ codex mcp add mcp-sqlserver -- npx -y @bilims/mcp-sqlserverMicrosoft SQL MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp-sqlserver] command = "npx" args = ["-y", "@bilims/mcp-sqlserver"]
Microsoft SQL MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user mcp-sqlserver npx -- -y @bilims/mcp-sqlserverMicrosoft SQL MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp-sqlserver": {
"command": "npx",
"args": [
"-y",
"@bilims/mcp-sqlserver"
]
}
}
}Microsoft SQL MCP araçları 8
README dosyasından algılandılist_databaseslist_tableslist_viewsdescribe_tableget_foreign_keysget_table_statsexecute_queryget_server_info
| list_databases | — | |
| list_tables | — | |
| list_views | — | |
| describe_table | — | |
| get_foreign_keys | — | |
| get_table_stats | — | |
| execute_query | — | |
| get_server_info | — |
Yapılandırma
SQLSERVER_DATABASESQLSERVER_ENCRYPTSQLSERVER_HOSTSQLSERVER_PASSWORDSQLSERVER_TRUST_CERTSQLSERVER_USER
| Ad | Açıklama | Sunucu |
|---|---|---|
| SQLSERVER_DATABASE | — | |
| SQLSERVER_ENCRYPT | — | |
| SQLSERVER_HOST | — | |
| SQLSERVER_PASSWORD | — | |
| SQLSERVER_TRUST_CERT | — | |
| SQLSERVER_USER | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirbilims/mcp-sqlserver is public and reachablegithub.com/bilims/mcp-sqlserver ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@bilims/mcp-sqlserver names bilims/mcp-sqlserver as sourcenpmjs.com/package/@bilims/mcp-sqlserver ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-03-31github.com/bilims/mcp-sqlserver ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @bilims/mcp-sqlserverGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
MCP SQL Server
A read-only Model Context Protocol (MCP) server for Microsoft SQL Server that enables AI agents to safely explore and query SQL Server databases.
Quick Start
Step 1: Install the Package
# Global installation (recommended)
npm install -g @bilims/mcp-sqlserver
# Verify installation
mcp-sqlserver --version
Step 2: Configure Your SQL Server Connection
Choose your SQL Server type and follow the configuration:
Azure SQL Database
export SQLSERVER_HOST="your-server.database.windows.net"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="your-database"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="false"
On-Premises SQL Server
export SQLSERVER_HOST="your-sql-server.company.com"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="your-database"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="true" # For self-signed certificates
Local SQL Server Express
export SQLSERVER_HOST="localhost\\SQLEXPRESS"
export SQLSERVER_USER="sa"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="master"
export SQLSERVER_ENCRYPT="false"
export SQLSERVER_TRUST_CERT="true"
Step 3: Test the Connection
# Test your configuration
mcp-sqlserver --help
# Quick connection test (press Ctrl+C to exit)
mcp-sqlserver
Step 4: Add to Claude Desktop
-
Find your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the MCP server configuration:
{
"mcpServers": {
"sqlserver": {
"command": "mcp-sqlserver",
"env": {
"SQLSERVER_HOST": "your-server.database.windows.net",
"SQLSERVER_USER": "your-username",
"SQLSERVER_PASSWORD": "your-password",
"SQLSERVER_DATABASE": "your-database",
"SQLSERVER_ENCRYPT": "true",
"SQLSERVER_TRUST_CERT": "false"
}
}
}
}
- Restart Claude Desktop
Step 5: Start Exploring!
Try these commands in Claude Desktop:
"Test the SQL Server connection""List all databases on the server""Show me the tables in [database name]""Describe the structure of the Users table""Show me foreign key relationships"
Features
- 🔒 Read-only operations: Only SELECT queries allowed, with comprehensive security validation
- 🗄️ Schema discovery: Explore databases, tables, views, relationships, and metadata
- 📊 Data exploration: Execute safe queries with built-in limits and timeouts
- 🔐 Enterprise-ready: Encrypted connections with certificate trust for production environments
- 🛡️ Security-first: Query validation, SQL injection protection, and access controls
Available Tools
Schema Discovery
list_databases- List all databases on the SQL Server instancelist_tables- List tables in a database or schemalist_views- List views in a database or schemadescribe_table- Get detailed table schema including columns, data types, and constraints
Relationship Analysis
get_foreign_keys- Get foreign key relationships for tablesget_table_stats- Get table statistics including row counts and size information
Data Exploration
execute_query- Execute read-only SELECT queries with safety validationget_server_info- Get SQL Server version, edition, and configuration details
Common Commands for Claude Desktop
Once your MCP server is configured, try these natural language commands:
Getting Started Commands
"Test the SQL Server connection"
"Show me server information"
"List all databases on this server"
"What tables are in the [database name] database?"
Database Exploration
"Describe the structure of the Users table"
"Show me foreign key relationships in this database"
"What are the largest tables by row count?"
"Give me a sample of data from the Orders table"
Advanced Analysis
"Help me understand the relationship between Orders and Customers"
"Show me all lookup tables in this database"
"What columns contain date/time information?"
"Find tables that might contain user authentication data"
Custom Queries
"Run this query: SELECT TOP 10 * FROM Products WHERE Price > 100"
"Show me all customers created in the last 30 days"
"What are the different product categories in the database?"
Installation
npm install
npm run build
Configuration
The server is configured using environment variables:
Required
SQLSERVER_USER- SQL Server usernameSQLSERVER_PASSWORD- SQL Server password
Optional
SQLSERVER_HOST- Server hostname (default: localhost)SQLSERVER_DATABASE- Default database nameSQLSERVER_PORT- Port number (default: 1433)SQLSERVER_ENCRYPT- Enable encryption (default: true)SQLSERVER_TRUST_CERT- Trust server certificate (default: true)SQLSERVER_CONNECTION_TIMEOUT- Connection timeout in ms (default: 30000)SQLSERVER_REQUEST_TIMEOUT- Request timeout in ms (default: 60000)SQLSERVER_MAX_ROWS- Maximum rows per query (default: 1000)
Usage
Environment Variables
export SQLSERVER_HOST="your-server.database.windows.net"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
export SQLSERVER_DATABASE="your-database"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="true"
Running the Server
npm start
Installation Options
Option 1: Global Installation (Recommended)
npm install -g @bilims/mcp-sqlserver
Option 2: Local Installation
npm install @bilims/mcp-sqlserver
npx mcp-sqlserver
Option 3: Run with npx (No Installation)
npx @bilims/mcp-sqlserver
Integration Examples
Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"sqlserver": {
"command": "mcp-sqlserver",
"env": {
"SQLSERVER_HOST": "your-server.database.windows.net",
"SQLSERVER_USER": "your-username",
"SQLSERVER_PASSWORD": "your-password",
"SQLSERVER_DATABASE": "your-database"
}
}
}
}
Claude Code CLI
# Set environment variables
export SQLSERVER_HOST="your-server"
export SQLSERVER_USER="your-username"
export SQLSERVER_PASSWORD="your-password"
# Use with Claude Code
claude mcp add sqlserver mcp-sqlserver
VSCode with MCP Extension
Install the MCP extension for VSCode and add the server configuration.
Security Features
Query Validation
- Only SELECT, WITH, SHOW, DESCRIBE, and EXPLAIN statements allowed
- Comprehensive blacklist of dangerous keywords (INSERT, UPDATE, DELETE, DROP, etc.)
- SQL injection pattern detection
- Automatic query sanitization
Connection Security
- TLS/SSL encryption enabled by default
- Server certificate trust options for enterprise environments
- Connection pooling with timeout controls
- Configurable request timeouts
Result Limits
- Maximum row limits per query (configurable)
- Automatic TOP clause injection for SELECT queries
- Query execution time tracking
- Memory usage protection
Example Queries
Once connected, you can use the tools through your MCP client:
// List all databases
await callTool("list_databases", {});
// List tables in a specific schema
await callTool("list_tables", { schema: "dbo" });
// Get table schema details
await callTool("describe_table", {
table_name: "Users",
schema: "dbo"
});
// Execute a read-only query
await callTool("execute_query", {
query: "SELECT TOP 10 * FROM Users WHERE active = 1",
limit: 10
});
// Get foreign key relationships
await callTool("get_foreign_keys", {
table_name: "Orders"
});
Development
# Install dependencies
npm install
# Build the project
npm run build
# Run in development mode
npm run dev
# Run linting
npm run lint
# Run tests
npm test
Troubleshooting
Connection Issues
- Verify server hostname and port
- Check if encryption/certificate settings match your SQL Server configuration
- Ensure user has appropriate read permissions
- Test connection using SQL Server Management Studio first
Permission Issues
The user account needs at minimum:
CONNECTpermission to the databaseSELECTpermission on tables/views you want to query- Access to system views for metadata queries
Common SQL Server Configurations
Azure SQL Database
export SQLSERVER_HOST="your-server.database.windows.net"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="false"
On-premises SQL Server with self-signed certificates
export SQLSERVER_HOST="sql-server.company.com"
export SQLSERVER_ENCRYPT="true"
export SQLSERVER_TRUST_CERT="true"
License
MIT
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
Support
For issues and questions:
- Check the troubleshooting section above
- Review SQL Server connection documentation
- Ensure MCP client compatibility
Built with the Model Context Protocol SDK for seamless AI integration.
Microsoft SQL MCP soruları
Microsoft SQL MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add mcp-sqlserver -- npx -y @bilims/mcp-sqlserver komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Microsoft SQL MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Microsoft SQL MCP hangi araçları sunar?
8 araç sunar; bunlar arasında list_databases, list_tables, list_views, describe_table, get_foreign_keys yer alır.
Bu MCP server SQL Server içindeki verileri değiştirebilir veya silebilir mi?
Hayır, sadece salt okunurdur: yalnızca SELECT, WITH, SHOW, DESCRIBE ve EXPLAIN ifadelerine izin verilir ve tehlikeli anahtar kelimeler kara listeye alınmıştır.
SQL Server bağlantısını nasıl yapılandırırım?
SQLSERVER_HOST, SQLSERVER_USER, SQLSERVER_PASSWORD ve SQLSERVER_DATABASE gibi ortam değişkenlerinin yanı sıra şifreleme seçeneklerini ayarlayın.
Server, şema keşfi için hangi araçları sağlar?
list_databases, list_tables, list_views ve describe_table araçlarının yanı sıra ilişki ve sorgu araçlarını sunar.
Azure SQL Database ile çalışır mı?
Evet, Azure kurulumu için şifreleme etkinleştirildiğinde ve sertifika güveni devre dışı bırakıldığında çalışır.
Bir sorgu kaç satır döndürebilir?
Satırlar, varsayılan değeri 1000 olan SQLSERVER_MAX_ROWS ile sorgu başına sınırlandırılmıştır.