Visual Studio Code ile SQL MCP Server'ı yerel olarak kullanmaya hızlı başlangıç

• Azure AI Foundry
• .NET Aspire
• Visual Studio Code
• Azure Container Apps

Önemli

SQL Model Bağlam Protokolü (MCP) Sunucusu, Veri API oluşturucusu sürüm 1.7 ve sonraki sürümlerde kullanılabilir.

Bu hızlı başlangıçta, Aspire olmadan yerel olarak bir SQL Model Bağlam Protokolü (MCP) Sunucusu çalıştırmak için Veri API'sini oluşturucu CLI kullanılır. Özel bir araç kullanarak bir veritabanı oluşturur, bir yapılandırma dosyası yapılandırıp SQL MCP Server'ı başlatır ve Visual Studio Code'dan (VS Code) bu veritabanına bağlanırsınız. Bu yol, kapsayıcılar veya barındırma çerçeveleri olmadan SQL MCP Server'ı keşfetmenin en kolay yoludur.

Önkoşullar

Başlamadan önce bu araçları yükleyin.

.NET 9+

Bu aracı zaten yüklemiş olabilirsiniz. komutunu çalıştırın dotnet --version ve sürüm 9.0 veya üzerini bildirdiğinden emin olun. .NET zaten varsa, yeniden yükleme güvenlidir ve yalnızca çalışma zamanınızı yeniler.

SQL Server 2016+

SQL Server veritabanına erişmeniz gerekir. Aşağıdaki çalışmalardan herhangi biri:

• SQL Server (Geliştirici veya Express)
• LocalDB (dosya tabanlı SQL Server)
• Docker'da SQL Server

Veri API'sini oluşturucu CLI'yi yükleme

dotnet new tool-manifest
dotnet tool install microsoft.dataapibuilder
dotnet tool restore

Uyarı

SQL MCP Server özellikleri Data API builder 1.7 ve sonraki sürümlerde kullanılabilir.

1. Adım: Örnek veritabanınızı oluşturma

Bu adımda adlı bir veritabanı oluşturacak ve adlı ProductsDbProductstek bir tabloyla bu veritabanının tohumlarını oluşturacaksınız.

SQLCMD, SQL Server Management Studio veya tercih edilen herhangi bir aracı kullanarak SQL örneğine bağlanın ve ardından şunu çalıştırın:

CREATE DATABASE ProductsDb;
GO

USE ProductsDb;
GO

CREATE TABLE dbo.Products (
    Id INT PRIMARY KEY,
    Name NVARCHAR(100) NOT NULL,
    Inventory INT NOT NULL,
    Price DECIMAL(10,2) NOT NULL,
    Cost DECIMAL(10,2) NOT NULL
);

INSERT INTO dbo.Products (Id, Name, Inventory, Price, Cost)
VALUES
    (1, 'Action Figure', 40, 14.99, 5.00),
    (2, 'Building Blocks', 25, 29.99, 10.00),
    (3, 'Puzzle 500 pcs', 30, 12.49, 4.00),
    (4, 'Toy Car', 50, 7.99, 2.50),
    (5, 'Board Game', 20, 34.99, 12.50),
    (6, 'Doll House', 10, 79.99, 30.00),
    (7, 'Stuffed Bear', 45, 15.99, 6.00),
    (8, 'Water Blaster', 35, 19.99, 7.00),
    (9, 'Art Kit', 28, 24.99, 8.00),
    (10,'RC Helicopter', 12, 59.99, 22.00);

Örnek veritabanınız hazır.

2. Adım: SQL MCP Server'ı yapılandırma

Dosyanızı dab-config.json oluşturmak istediğiniz klasörde tüm komutları çalıştırın.

Ortam dosyanızı oluşturma

Çalışma dizininizde .env adlı bir dosya oluşturun ve aşağıdaki satırı ekleyin (SQL Server bilgilerinizle özelleştirin):

MSSQL_CONNECTION_STRING=Server=localhost;Database=ProductsDb;Trusted_Connection=True;TrustServerCertificate=True

Uyarı

Tümleşik kimlik doğrulaması (Trusted_Connection=True) Windows üzerinde çalışır. SQL kimlik doğrulaması (Docker veya platformlar arası yaygın) için, localhost'a 1433 numaralı bağlantı noktasını eşlediğiniz varsayılarak, Server=localhost,1433;Database=ProductsDb;User Id=sa;Password=<YourPassword>;TrustServerCertificate=True yerine bunu kullanın.

Veri API oluşturucusu, çalışma dizininde mevcut olduğunda yerel .env bir dosyadan değişkenleri okuyabilir. Ortamınız dosyaları desteklemiyorsa .env , aşağıdaki komutları çalıştırmadan önce terminal oturumunuzda ortam değişkeni olarak ayarlayın MSSQL_CONNECTION_STRING .

Sunucuyu başlatma ve yapılandırma

Aşağıdaki komutları çalıştırın:

dab init --database-type mssql --connection-string "@env('MSSQL_CONNECTION_STRING')" --host-mode Development --config dab-config.json

dab add Products --source dbo.Products --permissions "anonymous:read" --description "Toy store products with inventory, price, and cost."

İsteğe bağlı olarak alan açıklamaları ekleme

dab update Products --fields.name Id --fields.primary-key true --fields.description "Product Id"
dab update Products --fields.name Name --fields.description "Product name"
dab update Products --fields.name Inventory --fields.description "Units in stock"
dab update Products --fields.name Price --fields.description "Retail price"
dab update Products --fields.name Cost --fields.description "Store cost"

SQL MCP Sunucunuz tamamen yapılandırılmıştır.

3. Adım: SQL MCP Server'ı başlatma

SQL MCP Server iki aktarım modunu destekler. İş akışınıza uygun olanı seçin.

Seçenek A: HTTP aktarımı (sunucu ayrı çalışır)

HTTP modunda, DAB'yi terminalde uzun süre çalışan bir işlem olarak başlatırsınız ve VS Code buna yerel bir HTTP uç noktası üzerinden bağlanır.

VS Code'dan bağlanmadan önce SQL MCP Server'ı ayrı bir terminalde başlatın.

Terminal açma ve çalıştırma

dab start --config dab-config.json

Bu komut SQL MCP Sunucusunu başlatır. Başlatma işleminden sonra terminal çıkışında dinleme URL'leri gösterilir. Bu hızlı başlangıçta MCP uç noktasının olduğu varsayılır http://localhost:5000/mcp. Bu terminali çalışır durumda tutun- Visual Studio Code bu HTTP uç noktasına bağlanır.

Uyarı

Çalışma zamanı ayarlarını dab-config.json içinde yapılandırarak veya ASPNETCORE_URLS gibi ortam değişkenlerini ayarlayarak bağlantı noktasını özelleştirebilirsiniz.

Seçenek B: stdio aktarım (işlemi VS Code yönetir)

Modda stdio DAB, doğrudan VS Code tarafından yönetilen bir alt işlem olarak başlatılır. Bir terminalde çalıştırmanız dab start; çalışma alanını açtığınızda VS Code otomatik olarak DAB'yi başlatır ve durdurur.

Bu mod yerel geliştirme için önerilir. Yönetilecek bir HTTP portu ve sürekli çalıştırılacak bir terminal süreci yok.

Uyarı

stdio aktarımı, "mcp": { "enabled": true }runtime bölümünün dab-config.json kısmında gereklidir. Tüm ayrıntılar için bkz stdio SQL MCP Server için taşıma.

Seçtiğiniz aktarım için VS Code MCP sunucu tanımını yapılandırmak için 4. Adıma atlayın.

4. Adım: VS Code'dan bağlanma

Önemli

Çalışma alanı, VS Code'un projeniz olarak ele alan kök klasördür. Ayarlar ve MCP sunucu tanımları yalnızca bu klasörün içinde geçerlidir. Tek bir dosya açarsanız, çalışma alanında değilsinizdir. Bir klasör açmanız gerekir.

Proje klasörünüzü açma

1. Dosya>Klasör Aç'ı seçin.
2. Dosyanızı dab-config.json içeren klasörü açın.

MCP sunucu tanımınızı oluşturma

adlı .vscode/mcp.json bir dosya oluşturun ve seçtiğiniz aktarım için içeriği ekleyin.

stdio taşıma (Seçenek B—yerel geliştirme için önerilir)

stdio modunda, VS Code, DAB'yi alt işlem olarak başlatır. Çalışan bir terminale ihtiyacınız yoktur; VS Code işlem yaşam döngüsünü yönetir.

{
  "servers": {
    "sql-mcp-server": {
      "type": "stdio",
      "command": "dab",
      "args": [
        "start",
        "--mcp-stdio",
        "role:anonymous",
        "--loglevel",
        "error",
        "--config",
        "${workspaceFolder}/dab-config.json"
      ]
    }
  }
}

Bu yapılandırmayı tam olarak yüklemek için aşağıdaki düğmeyi kullanın.

Uyarı

Varlık izinlerinde tanımlanmış bir rolle erişimi kısıtlamak veya genişletmek istiyorsanız role:anonymous öğesini değiştirin. Daha fazla bilgi için roller ve aktarım seçenekleri ile ilgili stdio SQL MCP Server için aktarım bölümüne bakın.

HTTP aktarımı (Seçenek A)

HTTP modunda VS Code, 3. Adımda başlattığınız DAB sunucusuna bağlanır. Terminalinizi dab start çalışır durumda tutun.

{
  "servers": {
    "sql-mcp-server": {
      "type": "http",
      "url": "http://localhost:5000/mcp"
    }
  }
}

Bu yapılandırmayı tam olarak yüklemek için aşağıdaki düğmeyi kullanın.

MCP sunucu bağlantısını başlatma

1. Komut Paleti'ni açın (macOS'ta Ctrl+Shift+P veya Cmd+Shift+P ).
2. Kullanılabilir sunucuları görüntülemek için MCP: Sunucuları Listele'yi çalıştırın.
3. sql-mcp-server (veya adını ne olursa olsun) seçin ve bağlanmak için Başlat'ı seçin.

Bağlandıktan sonra, Products varlığı describe_entities ve read_records gibi MCP araçları olarak görünür. Araç adları yapılandırmanıza göre farklılık gösterebilir.

Uyarı

VS Code MCP desteği gelişiyor. Yapılandırma şeması gelecek sürümlerde değişebilir. En son yönergeler için MCP tümleştirmesi için VS Code belgelerine bakın.

Bir araçla arama yapmayı deneyin

VS Code Copilot Sohbet'i açın ve şu istemi deneyin:

Which products have an inventory under 30?

İlgili içerik

• SQL MCP Server'a genel bakış
• stdio SQL MCP Server için aktarım
• SQL MCP Server'da veri işleme araçları
• SQL MCP Server'a anlamsal açıklamalar ekleme